home *** CD-ROM | disk | FTP | other *** search
/ Night Owl - The Best of BBS / Night Owl The Best of BBS (NOP-BBS) (Night Owl Publisher) (1994).iso / 014a / tamiga11.lha / transamiga1.1 / docs / TransAmiga.Doc < prev    next >
Text File  |  1992-03-05  |  302KB  |  7,483 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.                  __________
  16.                      /                        /|
  17.                     /   ___   __   _    ___  / |   _  _      ___   __
  18.                    /   /   | / |  /|  //_   /  |  /| /|   / /     / |
  19.                   /   /___/ /__| / | /   \ /___| / |/ |  / /  __ /__|
  20.                  /   /   \ /   |/  |/ ___//    |/     | / /___/ /   |
  21.                 /                        /     |
  22.  
  23.                                             //
  24.                                         \\ //
  25.                                          \X/
  26.  
  27.  
  28.                      __________________________________________
  29.  
  30.                                  TransAmiga BBS v1.1
  31.                     Shareware FidoNet BBS Software for the Amiga
  32.                       Copyright (C) 1990, 1991 By Timothy Aston
  33.                                  FidoNet 1:247/192.0
  34.                                  ALL RIGHTS RESERVED
  35.  
  36.                      __________________________________________
  37.  
  38.                                TransAmiga User Manual
  39.                       Copyright (C) 1990, 1991 By Timothy Aston
  40.                                  ALL RIGHTS RESERVED
  41.  
  42.                      __________________________________________
  43.  
  44.  
  45.  
  46.  
  47.  
  48.           TransAmiga BBS User Manual                                Page i
  49.  
  50.  
  51.  
  52.                                   Table of Contents
  53.  
  54.  
  55.                                      P A R T  I
  56.  
  57.                Introduction  . . . . . . . . . . . . . . . . . . . . .    1
  58.                     Welcome: . . . . . . . . . . . . . . . . . . . . .    1
  59.                     Canajan, eh: . . . . . . . . . . . . . . . . . . .    1
  60.                     TransAmiga's Roots:  . . . . . . . . . . . . . . .    2
  61.                     Philosophies Behind TransAmiga:  . . . . . . . . .    2
  62.                     System Requirements: . . . . . . . . . . . . . . .    3
  63.                     Features:  . . . . . . . . . . . . . . . . . . . .    3
  64.                     Registered vs. Unregistered: . . . . . . . . . . .    6
  65.                     Notes to TransAmiga v1.0x Users: . . . . . . . . .    6
  66.                     Back-Ups:  . . . . . . . . . . . . . . . . . . . .    6
  67.                Setting Up  . . . . . . . . . . . . . . . . . . . . . .    7
  68.                     The Modem: . . . . . . . . . . . . . . . . . . . .    7
  69.                     Preparation: . . . . . . . . . . . . . . . . . . .    7
  70.                     Upgrading From TransAmiga v1.0x: . . . . . . . . .    8
  71.                     Directories: . . . . . . . . . . . . . . . . . . .    8
  72.                     Copying Files: . . . . . . . . . . . . . . . . . .   10
  73.                     TransCfg:  . . . . . . . . . . . . . . . . . . . .   11
  74.                     Limits:  . . . . . . . . . . . . . . . . . . . . .   19
  75.  
  76.  
  77.                                     P A R T  I I
  78.  
  79.                Using TransAmiga  . . . . . . . . . . . . . . . . . . .   21
  80.                     Running TransAmiga:  . . . . . . . . . . . . . . .   21
  81.                     Troubleshooting: . . . . . . . . . . . . . . . . .   23
  82.                     Pull-Down Menus: . . . . . . . . . . . . . . . . .   23
  83.                     TransAmiga Online: . . . . . . . . . . . . . . . .   24
  84.                     Logging On:  . . . . . . . . . . . . . . . . . . .   24
  85.                     BBS Menus: . . . . . . . . . . . . . . . . . . . .   24
  86.                     Entering Commands: . . . . . . . . . . . . . . . .   26
  87.                Text Editors  . . . . . . . . . . . . . . . . . . . . .   27
  88.                     BBS Text Editors:  . . . . . . . . . . . . . . . .   27
  89.                     The Line Editor: . . . . . . . . . . . . . . . . .   27
  90.                     The Full-Screen Editor:  . . . . . . . . . . . . .   27
  91.                     Local Editor:  . . . . . . . . . . . . . . . . . .   28
  92.                     Reply Quoting: . . . . . . . . . . . . . . . . . .   29
  93.                Access Levels . . . . . . . . . . . . . . . . . . . . .   30
  94.                     User Access: . . . . . . . . . . . . . . . . . . .   30
  95.                     Access Flags:  . . . . . . . . . . . . . . . . . .   30
  96.                     New Users: . . . . . . . . . . . . . . . . . . . .   30
  97.                     Privileged Access: . . . . . . . . . . . . . . . .   31
  98.                     A Note on Users' Rights: . . . . . . . . . . . . .   31
  99.                TrMaint . . . . . . . . . . . . . . . . . . . . . . . .   32
  100.  
  101.  
  102.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  103.  
  104.  
  105.  
  106.  
  107.  
  108.           TransAmiga BBS User Manual                                Page ii
  109.  
  110.  
  111.                     User Maintenance:  . . . . . . . . . . . . . . . .   32
  112.                     Running TrMaint from CLI:  . . . . . . . . . . . .   32
  113.                     Sample ARexx Macro:  . . . . . . . . . . . . . . .   32
  114.                File Transfers  . . . . . . . . . . . . . . . . . . . .   34
  115.                     File Listings: . . . . . . . . . . . . . . . . . .   34
  116.                     Long Descriptions: . . . . . . . . . . . . . . . .   34
  117.                     Types of Transfers:  . . . . . . . . . . . . . . .   35
  118.                     TrXPR: . . . . . . . . . . . . . . . . . . . . . .   35
  119.                     File Credit: . . . . . . . . . . . . . . . . . . .   36
  120.  
  121.  
  122.                                    P A R T  I I I
  123.  
  124.                TransAmiga Multi-Line . . . . . . . . . . . . . . . . .   37
  125.                     About Multi-Line:  . . . . . . . . . . . . . . . .   37
  126.                     Setting Up Multi-Line: . . . . . . . . . . . . . .   37
  127.                     Running a Local-Only Line: . . . . . . . . . . . .   38
  128.  
  129.  
  130.                                     P A R T  I V
  131.  
  132.                Customizing the BBS . . . . . . . . . . . . . . . . . .   40
  133.                     Introduction:  . . . . . . . . . . . . . . . . . .   40
  134.                Changing Commands . . . . . . . . . . . . . . . . . . .   41
  135.                     The Command Files: . . . . . . . . . . . . . . . .   41
  136.                     Disabling Commands:  . . . . . . . . . . . . . . .   42
  137.                Text Files  . . . . . . . . . . . . . . . . . . . . . .   44
  138.                     Text Files in TransAmiga:  . . . . . . . . . . . .   44
  139.                     ANSI Graphics: . . . . . . . . . . . . . . . . . .   46
  140.                     More?: . . . . . . . . . . . . . . . . . . . . . .   47
  141.                     Imbedded Control Sequences:  . . . . . . . . . . .   47
  142.                Menus, Prompts & Help Files . . . . . . . . . . . . . .   50
  143.                     Menu Files:  . . . . . . . . . . . . . . . . . . .   50
  144.                     Prompt Files:  . . . . . . . . . . . . . . . . . .   51
  145.                     Help Files:  . . . . . . . . . . . . . . . . . . .   52
  146.                     Language Files:  . . . . . . . . . . . . . . . . .   52
  147.  
  148.  
  149.                                      P A R T  V
  150.  
  151.                FidoNet Explained . . . . . . . . . . . . . . . . . . .   54
  152.                     Introduction:  . . . . . . . . . . . . . . . . . .   54
  153.                     The Basics of FidoNet: . . . . . . . . . . . . . .   54
  154.                     Topography:  . . . . . . . . . . . . . . . . . . .   55
  155.                     Your Address:  . . . . . . . . . . . . . . . . . .   56
  156.                     The Nodelist:  . . . . . . . . . . . . . . . . . .   57
  157.                     Joining FidoNet: . . . . . . . . . . . . . . . . .   57
  158.                FidoNet and TransAmiga  . . . . . . . . . . . . . . . .   59
  159.                     Introduction:  . . . . . . . . . . . . . . . . . .   59
  160.  
  161.  
  162.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  163.  
  164.  
  165.  
  166.  
  167.  
  168.           TransAmiga BBS User Manual                                Page iii
  169.  
  170.  
  171.                     Setting up FidoNet:  . . . . . . . . . . . . . . .   60
  172.                     Events:  . . . . . . . . . . . . . . . . . . . . .   62
  173.                     Exporting Mail:  . . . . . . . . . . . . . . . . .   63
  174.                     Importing Mail:  . . . . . . . . . . . . . . . . .   63
  175.                     Time Driven Events:  . . . . . . . . . . . . . . .   63
  176.                     Advanced Usage:  . . . . . . . . . . . . . . . . .   64
  177.                     Other Mailers: . . . . . . . . . . . . . . . . . .   64
  178.                     TrUMP: . . . . . . . . . . . . . . . . . . . . . .   64
  179.                     TrAL:  . . . . . . . . . . . . . . . . . . . . . .   65
  180.                     Renumbering: . . . . . . . . . . . . . . . . . . .   66
  181.                     Offline Message Readers: . . . . . . . . . . . . .   67
  182.                     Using FidoNet: . . . . . . . . . . . . . . . . . .   67
  183.  
  184.  
  185.                                     P A R T  V I
  186.  
  187.                TransAmiga and ARexx  . . . . . . . . . . . . . . . . .   69
  188.                     Introduction:  . . . . . . . . . . . . . . . . . .   69
  189.                     Using ARexx with TransAmiga: . . . . . . . . . . .   69
  190.                     Writing ARexx Macros:  . . . . . . . . . . . . . .   71
  191.                     TransAmiga v1.0x Doors:  . . . . . . . . . . . . .   72
  192.                     ARexx Macro Ideas: . . . . . . . . . . . . . . . .   73
  193.                Command Reference . . . . . . . . . . . . . . . . . . .   74
  194.                     Introduction:  . . . . . . . . . . . . . . . . . .   74
  195.                     ABBEREXX Commands: . . . . . . . . . . . . . . . .   74
  196.                     ABBEREXX Variables:  . . . . . . . . . . . . . . .   77
  197.                     Commands Recognized with no Caller Online: . . . .   86
  198.                     SkyLine/C-Net ARexx Emulation: . . . . . . . . . .   88
  199.                     Example ARexx Macro: . . . . . . . . . . . . . . .   89
  200.  
  201.  
  202.                                    P A R T  V I I
  203.  
  204.                Politics  . . . . . . . . . . . . . . . . . . . . . . .   93
  205.                     Disclaimer:  . . . . . . . . . . . . . . . . . . .   93
  206.                     License: . . . . . . . . . . . . . . . . . . . . .   93
  207.                Registration  . . . . . . . . . . . . . . . . . . . . .   95
  208.                     Shareware: . . . . . . . . . . . . . . . . . . . .   95
  209.                     How to Register: . . . . . . . . . . . . . . . . .   95
  210.                     Support: . . . . . . . . . . . . . . . . . . . . .   97
  211.                Conclusion: . . . . . . . . . . . . . . . . . . . . . .   99
  212.                     Future:  . . . . . . . . . . . . . . . . . . . . .   99
  213.                     Comments:  . . . . . . . . . . . . . . . . . . . .   99
  214.                     Acknowledgements:  . . . . . . . . . . . . . . . .   99
  215.                     On Your Own: . . . . . . . . . . . . . . . . . . .  100
  216.  
  217.  
  218.                                  A P P E N D I C E S
  219.  
  220.  
  221.  
  222.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  223.  
  224.  
  225.  
  226.  
  227.  
  228.           TransAmiga BBS User Manual                                Page iv
  229.  
  230.  
  231.                Appendix I  . . . . . . . . . . . . . . . . . . . . . .  101
  232.                     Samples: . . . . . . . . . . . . . . . . . . . . .  101
  233.                     Sample TrapDoor Configuration: . . . . . . . . . .  101
  234.                     Sample Welmat Configuration: . . . . . . . . . . .  103
  235.                     Sample ConfMail Configuration: . . . . . . . . . .  106
  236.                Appendix II . . . . . . . . . . . . . . . . . . . . . .  109
  237.                     BBS Tools Reference: . . . . . . . . . . . . . . .  109
  238.                     TransAmiga Access Lock:  . . . . . . . . . . . . .  109
  239.                     TransAmiga BBS:  . . . . . . . . . . . . . . . . .  109
  240.                     TransAmiga BBS Line Activity Display:  . . . . . .  109
  241.                     TransAmiga Broadcaster:  . . . . . . . . . . . . .  109
  242.                     TransAmiga Configuration Tool: . . . . . . . . . .  110
  243.                     TransAmiga File Lister:  . . . . . . . . . . . . .  110
  244.                     TransAmiga User Maintenance: . . . . . . . . . . .  110
  245.                     TransAmiga DOS Shell:  . . . . . . . . . . . . . .  110
  246.                     TransAmiga Update File Areas:  . . . . . . . . . .  112
  247.                     TransAmiga Update Message Pointers:  . . . . . . .  112
  248.                Appendix III  . . . . . . . . . . . . . . . . . . . . .  113
  249.                     Amiga ANSI Codes:  . . . . . . . . . . . . . . . .  113
  250.                     Colour Change Codes: . . . . . . . . . . . . . . .  113
  251.                     Style Controls:  . . . . . . . . . . . . . . . . .  113
  252.                     Cursor Controls: . . . . . . . . . . . . . . . . .  113
  253.                     Miscellaneous Commands:  . . . . . . . . . . . . .  114
  254.  
  255.  
  256.                                    G L O S S A R Y
  257.  
  258.                     Access Levels: . . . . . . . . . . . . . . . . . .  115
  259.                     ANSI Graphics: . . . . . . . . . . . . . . . . . .  115
  260.                     Archive: . . . . . . . . . . . . . . . . . . . . .  115
  261.                     ARexx: . . . . . . . . . . . . . . . . . . . . . .  115
  262.                     Batch Transfer:  . . . . . . . . . . . . . . . . .  115
  263.                     BBS: . . . . . . . . . . . . . . . . . . . . . . .  116
  264.                     Door:  . . . . . . . . . . . . . . . . . . . . . .  116
  265.                     Download:  . . . . . . . . . . . . . . . . . . . .  116
  266.                     Echo:  . . . . . . . . . . . . . . . . . . . . . .  116
  267.                     FidoNet: . . . . . . . . . . . . . . . . . . . . .  116
  268.                     Freeware:  . . . . . . . . . . . . . . . . . . . .  116
  269.                     FTS-0001:  . . . . . . . . . . . . . . . . . . . .  116
  270.                     Intuition: . . . . . . . . . . . . . . . . . . . .  117
  271.                     Kludge Lines:  . . . . . . . . . . . . . . . . . .  117
  272.                     Mailer:  . . . . . . . . . . . . . . . . . . . . .  117
  273.                     Mail Processor:  . . . . . . . . . . . . . . . . .  117
  274.                     Matrix Mail: . . . . . . . . . . . . . . . . . . .  117
  275.                     Message Header:  . . . . . . . . . . . . . . . . .  117
  276.                     Multi-Line:  . . . . . . . . . . . . . . . . . . .  117
  277.                     Netmail: . . . . . . . . . . . . . . . . . . . . .  118
  278.                     Path Name: . . . . . . . . . . . . . . . . . . . .  118
  279.                     Public Domain: . . . . . . . . . . . . . . . . . .  118
  280.  
  281.  
  282.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  283.  
  284.  
  285.  
  286.  
  287.  
  288.           TransAmiga BBS User Manual                                Page v
  289.  
  290.  
  291.                     Protocol:  . . . . . . . . . . . . . . . . . . . .  118
  292.                     Release 2: . . . . . . . . . . . . . . . . . . . .  118
  293.                     Return Code: . . . . . . . . . . . . . . . . . . .  118
  294.                     Session Handler: . . . . . . . . . . . . . . . . .  118
  295.                     Shared Library:  . . . . . . . . . . . . . . . . .  119
  296.                     Shareware: . . . . . . . . . . . . . . . . . . . .  119
  297.                     Upload:  . . . . . . . . . . . . . . . . . . . . .  119
  298.                     Upload:Download Ratio: . . . . . . . . . . . . . .  119
  299.                     XPR Protocols: . . . . . . . . . . . . . . . . . .  119
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307.  
  308.  
  309.  
  310.  
  311.  
  312.  
  313.  
  314.  
  315.  
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334.  
  335.  
  336.  
  337.  
  338.  
  339.  
  340.  
  341.  
  342.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  343.  
  344.  
  345.  
  346.  
  347.  
  348.           TransAmiga BBS User Manual                                Page 1
  349.  
  350.  
  351.  
  352.  
  353.  
  354.                                      P A R T  I
  355.                                      ----------
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.                                     Introduction
  363.  
  364.  
  365.           Welcome:
  366.  
  367.                Welcome  to  TransAmiga  BBS.    TransAmiga  is  a Shareware
  368.                bulletin board system (BBS)  for  Amiga  personal computers.
  369.                TransAmiga attempts  was to provide an easy to setup and use
  370.                BBS programme  for not-so-demanding  tasks, and  at the same
  371.                time, incorporate flexibility and advanced features for more
  372.                serious purposes, such as networking and multi-line.
  373.  
  374.                Please  do  not  attempt  to  run  TransAmiga  without first
  375.                reading this  manual fully.   TransAmiga  is not  at all the
  376.                sort of programme that you can just run and experiment with.
  377.                There  are  many  crucial  steps,  so  be  sure  to read and
  378.                understand everything fully before proceeding.
  379.  
  380.                Please see PART VII near the  end  of  this  manual  for the
  381.                usage license.
  382.  
  383.                Some familiarity  with AmigaDOS, ARexx and general BBS terms
  384.                is assumed.
  385.  
  386.  
  387.           Canajan, eh:
  388.  
  389.                TransAmiga BBS is a  product of  the beautiful  and peaceful
  390.                nation of  Canada.   It that  big country  north of the USA,
  391.                where we like our  hockey  and  speak  French  with  a funny
  392.                accent.
  393.  
  394.                As  I'm  a  Canadian,  I  decided  to  write  this manual in
  395.                English, so United Statians may find some of  my spellings a
  396.                little  wierd  (programme,  colour,  etc).    Hope I haven't
  397.                confused you too much.
  398.  
  399.  
  400.  
  401.  
  402.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  403.  
  404.  
  405.  
  406.  
  407.  
  408.           TransAmiga BBS User Manual                                Page 2
  409.  
  410.  
  411.           TransAmiga's Roots:
  412.  
  413.                I started work on TransAmiga in December of 1989, just  as a
  414.                little something to do.  But as I started doing more work on
  415.                it, it I started to see that it  had some  potential to grow
  416.                into something  quite good.  In the spring of 1990, I became
  417.                a FidoNet point, and made  the  decision  that  I  would add
  418.                FidoNet  support  to  TransAmiga,  and  make  it  the  first
  419.                shareware FidoNet BBS for the Amiga.
  420.  
  421.                At this point in  time,  it  was  still  in  AmigaBASIC, and
  422.                extraordinarily  slow.    In  the  summer of 1990, I finally
  423.                purchased HiSoft BASIC, and  compiled TransAmiga.   In early
  424.                August 1990,  Great Lakes Amiga Central went up as the first
  425.                BBS running TransAmiga.  In September, Chris' Amiga BBS went
  426.                up,  as  my  second  test  site.   Finally, in late October,
  427.                TransAmiga v1.0 was released  to the  public.   The original
  428.                v1.0 matured over a few months in v1.06.
  429.  
  430.                In November  of 1990, work began on TransAmiga v1.1.  My aim
  431.                from the beginning was to  make  it  a  major  upgrade, with
  432.                several substantial new capabilities, but at that time I had
  433.                no idea how powerful it would actually become.  In May 1991,
  434.                TransAmiga v1.1  entered its  beta stage.  Finally, with its
  435.                release, Amiga users now  can find  real power  in shareware
  436.                BBS's, complete with FidoNet, ARexx, and multi-line.
  437.  
  438.  
  439.           Philosophies Behind TransAmiga:
  440.  
  441.                When I  wrote TransAmiga,  I had only ever used BBS software
  442.                from the caller's point  of view.   I  had never  run my own
  443.                BBS, nor  even looked  at any  BBS software from the SysOp's
  444.                end.  One of my primary objectives when I started  it was to
  445.                create an  attractive user interface for the caller.  Though
  446.                much effort has also  been made  to include  in TransAmiga a
  447.                large array  of powerful features for the SysOp, it is still
  448.                my strong belief that the purpose of a  BBS is  to serve its
  449.                callers - afterall, a BBS that doesn't get any callers isn't
  450.                much fun.
  451.  
  452.                Another major philosophy  behind  TransAmiga  is  the belief
  453.                that running  a BBS  should be  fun.  The world of Amiga BBS
  454.                software has become awfully intense and  competitive lately,
  455.                and the  prices of  high-quality BBS  software averages well
  456.                over $100.  Both these  facts  appear  contradictory  to the
  457.                idea that  running a  BBS is  supposed to  be a hobby.  With
  458.                TransAmiga I  hope  to  rekindle  this  spirit  of  fun that
  459.                started  the  BBS  world  in  the  first place by not always
  460.  
  461.  
  462.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  463.  
  464.  
  465.  
  466.  
  467.  
  468.           TransAmiga BBS User Manual                                Page 3
  469.  
  470.  
  471.                trying to be "one up everyone else", but by providing a good
  472.                quality software package at a reasonable.
  473.  
  474.                Lastly,  TransAmiga  relies  heavily  on  its  user-base  of
  475.                SysOps.  This entire package has been developed  by only one
  476.                person (myself  of course), so contributions from TransAmiga
  477.                users are valued highly.  My first priority  is enhancements
  478.                to  the  BBS  itself,  and  following  close  behind that is
  479.                keeping  in  regular   contact   with   my   users.     This
  480.                unfortunately  doesn't  leave  much  time for things such as
  481.                documentation, BBS support tools, etc.   Luckily, TransAmiga
  482.                SysOps have  done an excellent job in picking up this slack,
  483.                and I hope to see this trend continue in the future.
  484.  
  485.  
  486.           System Requirements:
  487.  
  488.                TransAmiga BBS requires at least an Amiga 500  with 1  MB of
  489.                RAM and  two floppy  disk drives  running Release 1.2 of the
  490.                operating system.  Though the BBS will function fine in this
  491.                environment,  it  was  designed  for  more powerful systems.
  492.                Additional memory and a  hard drive  of at  least 20  MB are
  493.                highly recommended.   You  will also find an accelerated CPU
  494.                and Release 2 of the operating  system advantageous  to have
  495.                when running TransAmiga.
  496.  
  497.                The following chart shows TransAmiga's minimum requirements,
  498.                the kind of equipment  that is  recommended for  good use of
  499.                the  BBS,   and  what   you  will  find  ideal  for  running
  500.                TransAmiga:
  501.  
  502.            Item         | Minimum        | Recommended    | Ideal          
  503.            System       | Amiga 500      | Amiga 2000     | Amiga 3000
  504.            CPU          | 68000          | 68000          | 68030
  505.            RAM          | 1 MB           | 1.5 MB         | 2.5 MB or more
  506.            O.S.         | 1.2            | 1.3            | 2.0
  507.            Modem        | 1200 baud      | 2400 baud      | DS-HST
  508.            Serial Port  | built-in port  | built-in port  | Multi-port card
  509.            Drive Space  | 2 floppies     | 20 MB          | 80 MB or more
  510.  
  511.  
  512.           Features:
  513.  
  514.                Here is a brief listing of the features of TransAmiga BBS:
  515.  
  516.                General -
  517.                 * Configure size, depth, and font of TransAmiga's screen.
  518.                 * Full ARexx support  with over  90 ARexx  commands.  ARexx
  519.  
  520.  
  521.  
  522.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  523.  
  524.  
  525.  
  526.  
  527.  
  528.           TransAmiga BBS User Manual                                Page 4
  529.  
  530.  
  531.                macros can  be installed  almost anywhere to provide maximum
  532.                flexibility.
  533.                 *  Can  run  many   SkyLine   ARexx   macros   with  little
  534.                modification.
  535.                 * Arbitrates  access to  all BBS  files that allows several
  536.                copies of the programme to be  run concurrently  without the
  537.                risk of  access collisions, allowing a multi-line BBS system
  538.                to be run.
  539.                 * Simple "idiot-proof" setup programme.
  540.                 * ANSI colour graphics optional for  each user,  with local
  541.                ANSI emulation (including both Amiga and IBM ANSI sequences,
  542.                as well as full 16 colour ANSI).
  543.                 * Optional command stacking or hot  keys, selected  by each
  544.                user.
  545.                 * When  entering commands  in the  BBS, users have the full
  546.                range of command line editing  keys  available,  as  well as
  547.                command line history.
  548.                 * Intuitive user interface.
  549.  
  550.                File Libraries -
  551.                 * Multiple  file areas,  each with  a minimum access level,
  552.                defined by the SysOp.
  553.                 * File transfers  using  external  protocols  setup  by the
  554.                SysOp.
  555.                 * Optional upload:download ratio for each user.
  556.                 * Batch and non-batch protocols supported.
  557.                 * Files can have an optional long description.
  558.                 * When listing files, users have a choice of either viewing
  559.                them a page at a time, or one file at a time.
  560.                 * Users can mark files for a batch download.
  561.  
  562.                Message Conferences -
  563.                 * Multiple SysOp defined message areas, each with a minimum
  564.                access level.
  565.                 * Messages can be public to be viewed by all, or privileged
  566.                to be read only by the  addresser, the  addressee, and those
  567.                with privileged access.
  568.                 * User can check for mail addressed to him/her at logon.
  569.                 *  Message  area  can  be defined as either local, private,
  570.                netmail, or echomail.
  571.  
  572.                FidoNet -
  573.                 * Able to read and write FidoNet messages  according to the
  574.                FTS-0001 standard.
  575.                 * Uses  existing FidoNet software that has been time tested
  576.                and proven reliable.   Unlike other  BBS programmes  it does
  577.                not  require  it's  own  custom  FidoNet  utilities,  so  no
  578.                battling with bugs and unimplemented features.
  579.  
  580.  
  581.  
  582.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  583.  
  584.  
  585.  
  586.  
  587.  
  588.           TransAmiga BBS User Manual                                Page 5
  589.  
  590.  
  591.                 *  Works  with  most   popular  Amiga   FidoNet  utilities,
  592.                including  ConfMail,   TrapDoor,  Foozle,  Welmat,  GCCHost,
  593.                FastPoint, TrapToss, Areafix, AmigaTick, etc.
  594.                 * You can set a  different  5-D  address  for  each FidoNet
  595.                message conference.
  596.                 * Able to read the Foozle message format.
  597.                 * Can create crashmail and file attaches.
  598.                 * Nodelist support.
  599.                 * Allows  you to  run mail  processing software while users
  600.                are online.
  601.                 * Supportive of 4-D  mail processing  software, and  can be
  602.                run in either a point or a node environment.
  603.  
  604.                SysOp Controls -
  605.                 * Optional daily time limit for each user.
  606.                 * User  can leave  a one line comment to the next user when
  607.                logging off.
  608.                 * Bulletin menu for  posting  text  files.    Each bulletin
  609.                requires a minimum access level to view.
  610.                 *  Every  command  can  be  assigned to any key, and can be
  611.                given any name.
  612.                 * Every command has a minimum access level.
  613.                 * Any command, file area,  message  area,  or  bulletin for
  614.                which a  user does  not have sufficient access, is invisible
  615.                to that user.
  616.                 * 256 different access levels plus a set of 8 access flags,
  617.                for controlling access to almost every facet of the BBS.
  618.                 * SysOp  can view  and edit  a user's stats from within the
  619.                programme while the user is online.
  620.                 * Fully interactive remote shell.
  621.                 * Supports three different  kinds of  editor: a line-editor
  622.                for ASCII  callers, a  full-screen editor  for ANSI callers,
  623.                and the editor of your choice for local calls.
  624.                 * User maintenance utility that can  be from  the BBS  as a
  625.                door or from the CLI.
  626.  
  627.                Configurability -
  628.                 *  You  set  the  key,  access,  flags,  and text for every
  629.                command in the BBS.
  630.                 * Add your own commands through ARexx.
  631.                 * You set the colours that should be used for text displays
  632.                within the BBS, so the BBS looks like you want it to.
  633.                 * Through  special control codes, text files can be made to
  634.                display over 40 different pieces of system/user information.
  635.                 * Create your own  custom menus  and menu  prompts, or have
  636.                the BBS displays it's own default style menus.
  637.                 *  Fully  configurable  screen setup including screen size,
  638.                depth, font, mode, etc.
  639.  
  640.  
  641.  
  642.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  643.  
  644.  
  645.  
  646.  
  647.  
  648.           TransAmiga BBS User Manual                                Page 6
  649.  
  650.  
  651.  
  652.           Registered vs. Unregistered:
  653.  
  654.                TransAmiga is a shareware package, meaning  you get  to look
  655.                at it free of charge, and once "evaluating" becomes "using",
  656.                you are obliged to register.  This method allows you to "try
  657.                before you buy", to get a really close look at it before you
  658.                decide to pay.
  659.  
  660.                You may use the unregistered version of TransAmiga for up to
  661.                20 days  before you  register.  Near the end of this manual,
  662.                full details are given on how to register, and what  you get
  663.                in return, so be sure to follow that carefully.
  664.  
  665.                If you  have not  registered TransAmiga  yet then TransAmiga
  666.                will still work fully,  however, users  will not  be allowed
  667.                online for more than 20 minutes in a day.
  668.  
  669.                When  you  register,  you  will get a small personalized key
  670.                file that will remove this restriction from TransAmiga.  The
  671.                actual TransAmiga programme itself is always the same, it is
  672.                the presence of the key file that determines  the difference
  673.                between unregistered and registered.
  674.  
  675.  
  676.           Notes to TransAmiga v1.0x Users:
  677.  
  678.                Because  of   the  enormous   changes  that  TransAmiga  has
  679.                undergone  in  this  new  release,  those  that  have  setup
  680.                previous versions  of TransAmiga  will not be able to simply
  681.                "plug-in and go".  Many of the file structures have changed,
  682.                thus a  certain amount  of re-setting-up must be done.  Read
  683.                the section on upgrading for complete  details on  the steps
  684.                you must take.
  685.  
  686.  
  687.           Back-Ups:
  688.  
  689.                Before  you  even  start,  it is highly recommended that you
  690.                backup all the TransAmiga files and  use the  backup as your
  691.                work copy.   It's  unlikely that  files get  lost, but it is
  692.                best to be safe.
  693.  
  694.  
  695.  
  696.  
  697.  
  698.  
  699.  
  700.  
  701.  
  702.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  703.  
  704.  
  705.  
  706.  
  707.  
  708.           TransAmiga BBS User Manual                                Page 7
  709.  
  710.  
  711.  
  712.                                      Setting Up
  713.  
  714.  
  715.           The Modem:
  716.  
  717.                TransAmiga should be able to work with virtually any kind of
  718.                modem, because you set all the modem commands by yourself.
  719.  
  720.                For TransAmiga  to work properly with your modem, it must be
  721.                set to include the baud rate  on connection  messages in the
  722.                format CONNECT  XXX, where XXX is the baud rate unless it is
  723.                a 300 baud connection in which just CONNECT  should be sent,
  724.                eg. CONNECT  2400.  On most Hayes compatible modems, this is
  725.                the default action, but on some  you must  enter the command
  726.                ATX4,  which  you  would  insert in you modem initialization
  727.                string (read on for more info  on your  modem initialization
  728.                string).   Consult your  modem manual for information on its
  729.                commands.
  730.  
  731.                It is very important that your modem is set so  that Carrier
  732.                Detect (CD)  and Data  Terminal Ready  (DTR) are not forced.
  733.                On some modems, you will need  to adjust  some DIP switches.
  734.                On modems with Non-volatile RAM, you may need to enter:
  735.  
  736.                  AT&F
  737.                  AT&D2&C1&W
  738.  
  739.                from a terminal programme.  Again, consult your modem manual
  740.                to find out more about this.
  741.  
  742.                TransAmiga also requires a 7-wire serial cable to work (most
  743.                serial cables are wired as such, this is rarely a problem).
  744.  
  745.                TransAmiga has  been fully tested with Hayes compatible 1200
  746.                and 2400 baud modems and Courier  HST modems,  including the
  747.                Dual-Standard HST.   TransAmiga supports the ability to lock
  748.                the serial port baud rate for maximum throughput.  How to do
  749.                this is explained later on.
  750.  
  751.  
  752.           Preparation:
  753.  
  754.                The setup procedure for TransAmiga has been made as painless
  755.                as possible, but setting up may still prove to be a slightly
  756.                complex procedure.  Please be sure to read this section over
  757.                a few times before you start, and always have the  manual by
  758.                you as  a reference  when you actually go through with setup
  759.                procedure.
  760.  
  761.  
  762.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  763.  
  764.  
  765.  
  766.  
  767.  
  768.           TransAmiga BBS User Manual                                Page 8
  769.  
  770.  
  771.  
  772.                A lot of file moving and  directory making  will be involved
  773.                in  setting  up  TransAmiga.    Thanks  to the new Release 2
  774.                Workbench, this is relatively painless.   If you  do not yet
  775.                have the  Release 2  Workbench, a  directory utility such as
  776.                SID or CLImate is recommended. And  of course  if you prefer
  777.                the shell, you may use that too.
  778.  
  779.                Here are the general steps that will be taken in the setup:
  780.  
  781.                  1. Creation   of   some   directories   and   making  some
  782.                     assignments.
  783.                  2. Copy some directories from the TransAmiga distribution.
  784.                  3. Use the  TransCfg  tool  to  perform  the  rest  of the
  785.                     setting up,  including the initializing of some general
  786.                     BBS settings, the setting up of file and message areas,
  787.                     etc.
  788.  
  789.  
  790.           Upgrading From TransAmiga v1.0x:
  791.  
  792.                If you  have already setup and are using v1.0x of TransAmiga
  793.                (that is, any version from v1.0 to v1.07), it will  still be
  794.                necessary to  follow a good deal of the setup procedure.  If
  795.                you do not have a v1.0x TransAmiga, skip to the next section
  796.                on Directories.
  797.  
  798.                All of TransAmiga's configuration files have been changed in
  799.                v1.1 from the config  files used  by the  v1.0x versions, as
  800.                have  the  command  files.    The  .Exts files are gone too,
  801.                replaced by the .Rx  files for  executing ARexx  macros (see
  802.                the section  on ARexx  for more details).  The format of the
  803.                user files,  and the  format of  the file  listings has also
  804.                changed.
  805.  
  806.                The  message  conferences  themselves  are unchanged (except
  807.                that you  must now  use a  programme called  TrUMP to update
  808.                FidoNet areas,  see the  FidoNet section  for details).  You
  809.                will be able  to  convert  your  user  files  and  your file
  810.                listing,  but  everything  else  should  be  deleted.   This
  811.                includes your old config files, your old command  files, and
  812.                your .Exts files.  If you have not setup your directories as
  813.                described below, then it is recommended that you change over
  814.                to the suggested configuration.
  815.  
  816.  
  817.           Directories:
  818.  
  819.  
  820.  
  821.  
  822.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  823.  
  824.  
  825.  
  826.  
  827.  
  828.           TransAmiga BBS User Manual                                Page 9
  829.  
  830.  
  831.                The  first  step  in  the  setup procedure is to create some
  832.                directories.  If you are using a hard drive system, you will
  833.                need to create a unique directory for all the BBS files.  It
  834.                is suggested  that you  call this  directory 'BBS', although
  835.                any name  is fine.   Within this directory you should create
  836.                one directory for all  your  message  areas  ('Mail'  is the
  837.                recommended name  to give it) and one directory for all your
  838.                file areas ('File' is the recommended name for that).
  839.  
  840.                In this manual,  directory  names  and  assignments  will be
  841.                somewhat standardized  for the  sake of  clarity.  If you do
  842.                not wish to use the  assignments  suggested,  that  is fine.
  843.                For  example,  because  of  the  way your hard drives may be
  844.                partitioned, you may wish  to have  file areas  on different
  845.                drives,  which   is  perfectly   acceptable.     But  it  is
  846.                recommended that  for the  most part  you try  to follow the
  847.                suggestions so  as to  make setting up as straightforward as
  848.                possible.
  849.  
  850.                For the main BBS  directory you  should make  the assignment
  851.                'BBS:' point it.  The assignment 'Mail:' should point to the
  852.                message areas  directory, and  'File:' should  point to your
  853.                file  areas  directory.    This  is done by using the Assign
  854.                command, eg:
  855.  
  856.                  Assign BBS: SYS:BBS
  857.                  Assign Mail: BBS:Mail
  858.                  Assign File: BBS:File
  859.  
  860.                If you are running off a floppy based system, you'll have to
  861.                dedicate two  whole disks to the BBS.  The first disk should
  862.                be a  bootable disk  called 'BBS'.   Be  sure all libraries,
  863.                devices,  commands  and  other  files  required  for  normal
  864.                operation are present on it.  On the  second drive  you will
  865.                have the  message areas.  Call that disk 'Mail'.  There will
  866.                not be enough room for file areas.
  867.  
  868.                Within the BBS, File, and Mail  directories, TransAmiga uses
  869.                several other directories, as follows:
  870.  
  871.                 * The  system directory  for keeping  various general files
  872.                for system upkeep.
  873.                 * A configurations directory for keeping  the various files
  874.                that say how the BBS is set up.
  875.                 * The users directory for keeping individual user files.
  876.                 *  A  text  directory  where  all  help files, menus, title
  877.                screens, and other text files shown to users are kept.
  878.                 * The bulletins directory where file to be displayed at the
  879.                bulletins menu are kept.
  880.  
  881.  
  882.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  883.  
  884.  
  885.  
  886.  
  887.  
  888.           TransAmiga BBS User Manual                                Page 10
  889.  
  890.  
  891.                 * The  extras directory  for miscellaneous files created by
  892.                online games, BBS utilities, and other  external BBS related
  893.                tools.
  894.                 * The  ARexx macros  directory, where the BBS looks for any
  895.                ARexx macros.  If you do not intend  to run  ARexx, then you
  896.                will of course not have an ARexx directory.
  897.                 * One  directory for  each file and message area you choose
  898.                to setup.  These  naturally  contain  all  the  messages and
  899.                files for those areas.
  900.  
  901.                It  is  also  suggested  that  you create a directory called
  902.                'Bin' to keep all the executable files for use with the BBS.
  903.                This directory  should be  added to  your search path, using
  904.                the path command, eg:
  905.  
  906.                 Path BBS:Bin ADD
  907.  
  908.                which  you  will  probably  want  to  add  to  your Startup-
  909.                Sequence.
  910.  
  911.                These  simple  tree  diagrams  illustrates an example of how
  912.                your directory structures may  look  with  example  file and
  913.                message areas:
  914.  
  915.                                           BBS:
  916.                                            |
  917.                   +--------+-------+-------+-------+--------+-------+
  918.                   |        |       |       |       |        |       |
  919.                System  Configs   Users   Text    Rexx   Bulletins  Extras
  920.  
  921.                                         File:
  922.                                           |
  923.                          +----------+-----+-----+---------+
  924.                          |          |           |         |
  925.                      Telecomm     Prog        Games     Utils
  926.  
  927.                                         Mail:
  928.                                           |
  929.                          +----------+-----+-----+---------+
  930.                          |          |           |         |
  931.                      Personal    General     Computers  Sports
  932.  
  933.                You  don't  have  to  create  these directories that live in
  934.                BBS:, Mail: and File:  yourself,  as  they  will  be created
  935.                automatically later  on, you  should just be aware that they
  936.                do exist and have a general idea of what they are for.
  937.  
  938.  
  939.           Copying Files:
  940.  
  941.  
  942.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  943.  
  944.  
  945.  
  946.  
  947.  
  948.           TransAmiga BBS User Manual                                Page 11
  949.  
  950.  
  951.  
  952.                Before you start setting up,  a  few  of  TransAmiga's files
  953.                need to  be copied.  If you are a registered user, all these
  954.                files will be on your registration disk.
  955.  
  956.                You will  need  to  copy  the  'Bin',  'Text'  and 'Configs'
  957.                directories  into  your  BBS:  directory.    If you've got a
  958.                directory utility, or are using the new Release 2 Workbench,
  959.                this is  simple enough.   If you are using Shell, then you'd
  960.                use a commands such as:
  961.  
  962.                  Copy Bin BBS:Bin all
  963.                  Copy Configs BBS:Configs all
  964.                  Copy Text BBS:Text all
  965.  
  966.                You'll also  need  to  copy  the  contents  of  Libs  on the
  967.                TransAmiga disk to your libs: directory.
  968.  
  969.                Next you  will need to install the font you wish to use with
  970.                TransAmiga.  At least for the time being,  it is recommended
  971.                you use  the provided  TransIBM 8 point font.  To install it
  972.                from the shell, you'd use:
  973.  
  974.                  Copy Fonts Fonts: all
  975.  
  976.                All other files  required  by  TransAmiga  should  be fairly
  977.                standard.   For example,  you will naturally need the serial
  978.                device  your  modem   uses   (usually   serial.device),  the
  979.                diskfont.library, some DOS commands, etc.
  980.  
  981.                The basic preparation stages are now complete.
  982.  
  983.  
  984.           TransCfg:
  985.  
  986.                TransCfg  is  a  utility  used  to  help make setting up and
  987.                maintaining the BBS  easier.    If  you  followed  the above
  988.                procedure,  then   it  will   be  located  in  your  BBS:Bin
  989.                directory, although  it  doesn't  particularly  matter where
  990.                you put it.
  991.  
  992.                TransCfg must  be loaded from the Shell.  Upon execution, it
  993.                will  ask  you  for   the   name   of   TransAmiga's  master
  994.                configuration  file.    The master system configuration file
  995.                contains general information that is vital  to the operation
  996.                of the  BBS.  You can call this anything you want, but it is
  997.                recommended that you call it TransAmiga.Cfg, and place it in
  998.                your  BBS:Configs  directory.    Therefore,  you would enter
  999.                'BBS:Configs/TransAmiga.Cfg'.
  1000.  
  1001.  
  1002.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  1003.  
  1004.  
  1005.  
  1006.  
  1007.  
  1008.           TransAmiga BBS User Manual                                Page 12
  1009.  
  1010.  
  1011.  
  1012.                When you give TransCfg the name of your master configuration
  1013.                file, it  will see  that this  is your first time setting up
  1014.                the BBS.  What follows will  be a  series of  questions that
  1015.                you must  answer in  order to get the BBS setup according to
  1016.                how you want it.  Before  each set  of questions  there is a
  1017.                brief paragraph explaining what you are being asked for.
  1018.  
  1019.                If  you  wish  to  set  up  a system running multiple lines,
  1020.                you'll have to be a bit patient.  Just set up a  single line
  1021.                for now, adding additional lines will be described later on.
  1022.  
  1023.                When entering information, default values will be shown just
  1024.                below, you may accept the default by just hitting RETURN, or
  1025.                you can  enter your  own.  Default values will automatically
  1026.                be set  for  you.    If  you  followed  the  suggestions for
  1027.                directory names  and assignments  given above, then you will
  1028.                be able to accept most of the defaults as they are.
  1029.  
  1030.                General -
  1031.                This is where  you  setup  your  master  configuration file.
  1032.                There will  be several  questions covering  a wide area that
  1033.                will be asked of you here.
  1034.  
  1035.                The first two questions are simple enough, simply enter your
  1036.                name, and the name you wish to call your board.
  1037.  
  1038.                You will  need to  enter the length of the idle timer.  When
  1039.                an online user is idle for this length of time  (i.e. hasn't
  1040.                entered   any   commands   or   other   text),  he/she  will
  1041.                automatically be logged off.
  1042.  
  1043.                Then you must enter the names of the  various directory that
  1044.                we discussed earlier.  You should give the full pathnames of
  1045.                these directories with any drive/assignment specifiers.   It
  1046.                is recommended that you accept the default values for all of
  1047.                these, as all the  examples  throughout  this  manual assume
  1048.                these  values.    If  you  wish, though, you can set them to
  1049.                anything you want.  Those that do not have ARexx should need
  1050.                not worry where their ARexx directory points to, as it won't
  1051.                be used.
  1052.  
  1053.                It does not  matter  if  you  have  not  already  made these
  1054.                directories yourself,  as TransCfg  will make  them for you.
  1055.                You must, however, have made the BBS: assignment  (or have a
  1056.                disk labelled that).
  1057.  
  1058.                The  next  questions  deal  with  modem  configuration.  The
  1059.                maximum  speed  of  your  modem  should  be  straightforward
  1060.  
  1061.  
  1062.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  1063.  
  1064.  
  1065.  
  1066.  
  1067.  
  1068.           TransAmiga BBS User Manual                                Page 13
  1069.  
  1070.  
  1071.                enough.  If your modem supports baud rate locking, enter the
  1072.                speed that you wish to lock the baud rate at.  You must also
  1073.                enter  the  minimum  baud  rate you wish to support, callers
  1074.                connecting at a lower baud rate  than this  will be politely
  1075.                logged off.   You  will also  be asked  for the  name of the
  1076.                serial.device and unit you wish to use.   Usually, you would
  1077.                just select the defaults as this is for the Amiga's internal
  1078.                serial port.  If  you  are  using  a  third-party multi-port
  1079.                serial  board,   then  you   will  need   to  refer  to  its
  1080.                documentation to find out what you need to enter here.
  1081.  
  1082.                Then you must enter  a set  of 4  modem commands.   Refer to
  1083.                your  modem  user  manual  to learn more about what commands
  1084.                your modem accepts.  The defaults should work with most 1200
  1085.                and 2400  baud modems.   The  modem initialization string is
  1086.                the command TransAmiga sends to the modem when it starts up.
  1087.                This  may  vary  a  lot  depending  on  your  modem and your
  1088.                personal preferences, but it must turn  auto-answer on.   It
  1089.                could  be  something  like  'ATZ|~~~ATX4M0S0=1|~' which will
  1090.                reset the modem, turn on  long  CONNECT  messages,  turn the
  1091.                speaker off,  and turn  auto-answer on with a standard Hayes
  1092.                compatible modem.  The modem exit command is what TransAmiga
  1093.                sends to  the modem  when it quits.  Usually a simple 'ATZ|'
  1094.                will suffice.  The  local logon  and local  log off commands
  1095.                are what is sent to the modem just before a local logon, and
  1096.                at the end of a local logon.  You may wish to have the modem
  1097.                go off hook during a local logon so you would enter 'ATH1|~'
  1098.                and 'ATH0|~' respectively.  Note that  the pipe  (|) is used
  1099.                to  indicate  to  TransAmiga  that it should send a carriage
  1100.                return at that point, and that  the tilde  (~) causes  it to
  1101.                pause for a half second.
  1102.  
  1103.                Many modems  will not  respond properly to commands that are
  1104.                sent too quickly.  Some require a pause after an  AT, others
  1105.                requires pauses  between commands.  For this reason, you may
  1106.                have to use several ~ in  your modem  commands so  that they
  1107.                get  sent  slow  enough.    A  little experimentation may be
  1108.                required here.
  1109.  
  1110.                The next few questions have to do with user access.  You may
  1111.                want  to  accept  the  defaults  values  for now and perhaps
  1112.                adjust them more to your liking later on.   First  comes the
  1113.                time limits,  upload:download ratio, flags, and access level
  1114.                a  user  takes  on  right  after  filling  in  the  new user
  1115.                questionnaire (i.e.  a first time caller who has just joined
  1116.                the board, you have not got a chance  to validate  this user
  1117.                yet).   The next  question asks  what access  level shall be
  1118.                known as "Privileged" access.  User's with privileged access
  1119.                can read  privileged mail including private netmail, and can
  1120.  
  1121.  
  1122.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  1123.  
  1124.  
  1125.  
  1126.  
  1127.  
  1128.           TransAmiga BBS User Manual                                Page 14
  1129.  
  1130.  
  1131.                see the "kludge" lines in FidoNet mail.  Only the  SysOp and
  1132.                assistant SysOps are meant to have this kind of access.  For
  1133.                more  information   about  how   TransAmiga  handles  access
  1134.                controls,  see  the  appropriate  section  later  on in this
  1135.                manual.
  1136.  
  1137.                The last questions in the first section deal  with aesthetic
  1138.                preferences.  Here you set the size of TransAmiga's terminal
  1139.                window, the font and point size to be  used, whether  or not
  1140.                TransAmiga should  open a  custom screen  or not,  and if so
  1141.                that screen's depth,  size  and  mode.    When  entering the
  1142.                screen size,  you may enter 0 for either the width or height
  1143.                (or both) to have them default to the size of  the Workbench
  1144.                screen.
  1145.  
  1146.                The defaults  are for  an 8  colour medium-resolution screen
  1147.                that is slightly overscanned so as to fit 80 columns  and 23
  1148.                rows.   It also  uses the  TransIBM font so be sure that you
  1149.                have installed that in your Fonts: directory.
  1150.  
  1151.                Here you also set some colour  preferences used  by the BBS.
  1152.                To save  the most  memory, have TransAmiga use the Workbench
  1153.                screen without a sizing gadget.
  1154.  
  1155.                You also choose the three colours the BBS will use  for text
  1156.                messages.  The values must be 0-7 and correspond to the ANSI
  1157.                colour values.  In general, your text input colour should be
  1158.                white (colour 7), your prompt colour bright (eg. colour 3 or
  1159.                6) and your trim colour slightly darker (eg. colour 4 or 1).
  1160.                Some experimentation may be required to find a colour scheme
  1161.                you like.
  1162.  
  1163.                You will be asked whether you want input  text fields  to be
  1164.                displayed.   What is  meant by this, is if you wish a colour
  1165.                rectangle to be drawn for ANSI users to  indicate where they
  1166.                will be  entering text.  This rectangle will be drawn in the
  1167.                trim colour you selected.    You  are  given  the  option of
  1168.                enabling or disabling this as it will take a few instants to
  1169.                draw for callers at slow baud rates.   You should experiment
  1170.                with it on and off to see which you prefer.
  1171.  
  1172.                If you  choose to  open TransAmiga on its own custom screen,
  1173.                you will have the option of having TransAmiga also display a
  1174.                blue backdrop  behind the terminal and status windows.  This
  1175.                is purely to add aesthetic appeal  for those  that configure
  1176.                their screen  such that  the terminal  window does not cover
  1177.                the entire screen.   For example,  if you  wish to configure
  1178.                your screen preferences to recreate the look of the original
  1179.  
  1180.  
  1181.  
  1182.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  1183.  
  1184.  
  1185.  
  1186.  
  1187.  
  1188.           TransAmiga BBS User Manual                                Page 15
  1189.  
  1190.  
  1191.                version of TransAmiga, you  would use  this option.   Beware
  1192.                that it does take up a significant amount of memory.
  1193.  
  1194.                The file  you specified  when you executed TransCfg will now
  1195.                be created with all the information you just entered in it.
  1196.  
  1197.                Messages -
  1198.                Next you will set up the  message  areas.    The  purpose of
  1199.                having  separate   message  areas   is  so  that  completely
  1200.                different topics will be separated.   You may  setup as many
  1201.                message areas  as you  wish.   The defaults are for just two
  1202.                simple message areas,  one  for  private  mail  and  one for
  1203.                public mail.
  1204.  
  1205.                The first  few questions  here deal with FidoNet, which will
  1206.                not be described just  yet, so  skip over  these for  now by
  1207.                hitting RETURN until you are asked how many message areas to
  1208.                setup.  If you are interested in FidoNet, it will be covered
  1209.                in detail later on.
  1210.  
  1211.                For each  message area, you must choose an appropriate name.
  1212.                Examples might be "Sports  Talk", "Current  Affairs", "Amiga
  1213.                Users",  etc.    Next,  enter  the full path to that message
  1214.                area's unique directory.  If you haven't made the directory,
  1215.                TransCfg will make it for you, though any parent directories
  1216.                must already exist.   It is  recommended that  you have your
  1217.                message directories within Mail:, but this is not essential.
  1218.                Spreading message areas over  multiple  drives  is perfectly
  1219.                acceptable, albeit a little confusing.
  1220.  
  1221.                Now enter  the type  of message  area.   For the time being,
  1222.                enter 0 for a normal message area or 1 for an all-privileged
  1223.                message   area   (that   is,   all   messages  entered  will
  1224.                automatically be assumed to be private), see the  section on
  1225.                FidoNet later  on in  this manual for information on net and
  1226.                echo mail areas.  Each area has a minimum access  level, and
  1227.                also flags associated with it.
  1228.  
  1229.                Each  area  also  has  minimum access levels for reading and
  1230.                writing.  These can  be  used  to  create  read-only message
  1231.                areas, or  to keep first time callers from entering messages
  1232.                in certain areas.
  1233.  
  1234.                For each area you must specify a quote  lead-in line.   When
  1235.                users are  quoting lines  from the message they are replying
  1236.                to, it is often desirable to have a simple intro line before
  1237.                the quotation so that people reading the message know what's
  1238.                going on.  Simply  enter the  text for  this line.   You may
  1239.  
  1240.  
  1241.  
  1242.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  1243.  
  1244.  
  1245.  
  1246.  
  1247.  
  1248.           TransAmiga BBS User Manual                                Page 16
  1249.  
  1250.  
  1251.                enter a  few codes  to have  certain information substituted
  1252.                into the string:
  1253.  
  1254.                  %n -    the name of the user who wrote the message you are
  1255.                          replying to
  1256.                  %a -    the name  of the person that message was addressed
  1257.                          to
  1258.                  %d -    the date the original was written
  1259.                  %t -    the time the original was written
  1260.  
  1261.                Some example quote lead-in lines:
  1262.  
  1263.                  In a message sent <%d %t>, %n wrote to %a:
  1264.  
  1265.                  %n uttered this gibberish at %t, %d to %a:
  1266.  
  1267.                You may decide whether  or not  you wish  to allow  users to
  1268.                post messages  under their "handles" in each conference.  If
  1269.                you say yes, users that have  setup a  handle for themselves
  1270.                will be  prompted as  to whether  or not they wish to use it
  1271.                for the message they are posting.
  1272.  
  1273.                You shouldn't normally  need  to  adjust  the  low  and high
  1274.                message number,  and for  now leave  them at  zero.  For all
  1275.                local message areas you must  enter  the  maximum  number of
  1276.                messages to  keep in  the area at one time.  Once that limit
  1277.                has   been   exceeded,   TransAmiga   automatically  deletes
  1278.                messages, starting at the oldest.  Finally, you are prompted
  1279.                to reset the users' last read pointers.  You must answer Yes
  1280.                to this option whenever you are first setting up an area, as
  1281.                this initializes the data file TransAmiga uses to keep track
  1282.                of users' last read messages.
  1283.  
  1284.                After setting  up the individual areas, some other questions
  1285.                must be  answered.   You must  enter the  user name messages
  1286.                entered via  the feedback command should go to, and to which
  1287.                area number they should be placed in.
  1288.  
  1289.                Finally, you will be asked for the external editor commands.
  1290.                Once again, there are some % codes you can use to substitute
  1291.                in information:
  1292.  
  1293.                  %n -    the number of the BBS line starting the editor
  1294.                  %f -    the filename of the  file that  should contain the
  1295.                          message text to be saved.
  1296.                  %q -    the name  of the  file containing  the quoted text
  1297.                          when you are replying to a message.
  1298.                  %b -    the real  (non-locked)  baud  rate  of  the online
  1299.                          caller.
  1300.  
  1301.  
  1302.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  1303.  
  1304.  
  1305.  
  1306.  
  1307.  
  1308.           TransAmiga BBS User Manual                                Page 17
  1309.  
  1310.  
  1311.  
  1312.                The full-screen  editor command  is the  programme that gets
  1313.                run when online callers invokes the  full-screen editor (the
  1314.                different text editors are described in greater detail later
  1315.                on).  You should  use the  provided TrEd  programme for this
  1316.                (registered users only).  The command need simply by:
  1317.  
  1318.                  BBS:Bin/TrEd %f -q%f -n%n
  1319.  
  1320.                For the local editor command, you should give the command to
  1321.                start up your favourite  text  editor.    Any  editor should
  1322.                work, such as Ed, MEmacs, QEd, etc.  For example, to use QEd
  1323.                as your text editor, you could use:
  1324.  
  1325.                  Work:Tools/QEd %f
  1326.  
  1327.                Most  other  text  editors  should  require  similar command
  1328.                lines.
  1329.  
  1330.                Files -
  1331.                Like the  message conferences,  the files section is divided
  1332.                up into separated libraries.  The defaults are quite simple,
  1333.                just two  file areas.   If you are using a dual floppy drive
  1334.                system,  then  you  will  not  have  enough  space  for file
  1335.                libraries, but  you will still have to setup a "dummy" area.
  1336.                Just call this anything, have  the  directory  as  RAM:, and
  1337.                give it access 256 so no one can get there.
  1338.  
  1339.                Prior to  setting up the libraries, you must specify what is
  1340.                considered to be a "full" drive.  TransAmiga  will refuse to
  1341.                allow uploads when less than the amount you specify is free.
  1342.                Generally it is desirable  to set  this to  at least  50k so
  1343.                that  the  drive  will  not  become full from messages being
  1344.                posted and other BBS operations.
  1345.  
  1346.                Setting up the actual file libraries setup to  start with is
  1347.                quite similar  to the message area setup.  Each file library
  1348.                must have a name, a unique path, access, flags, and read and
  1349.                write access  levels.   It is recommended that all your file
  1350.                directories are somewhere within File:, but  as with message
  1351.                directories, this is not essential.
  1352.  
  1353.                After  this,  you  must  setup  the file transfer protocols.
  1354.                TransAmiga executes external AmigaDOS programmes to  do file
  1355.                transfers.    This  has  been  done  to  allow  for  maximum
  1356.                flexibility  when  it  comes  to  setting  up  file transfer
  1357.                protocols.   For most  of your  protocols, it is recommended
  1358.                that you use the included TrXPR programme, as it was written
  1359.                with  TransAmiga  specifically  in  mind,  and  supports the
  1360.  
  1361.  
  1362.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  1363.  
  1364.  
  1365.  
  1366.  
  1367.  
  1368.           TransAmiga BBS User Manual                                Page 18
  1369.  
  1370.  
  1371.                popular XPR libraries.   The defaults  will give  you Zmodem
  1372.                batch  and  Xmodem-CRC  protocols  via TrXPR, but you should
  1373.                consult the  TrXPR  documentation  for  more  information on
  1374.                using it.
  1375.  
  1376.                For each  protocol, you  must enter the name.  Then you must
  1377.                say whether or not  the protocol  is capable  of doing batch
  1378.                transfers (where multiple files can be sent in one session).
  1379.                Lastly,   you   enter   the   send   and   receive  commands
  1380.                respectively.  TransAmiga allows a few imbedded commands for
  1381.                automatically substituting values into the command line:
  1382.  
  1383.                  %n -    the number of the BBS line
  1384.                  %d -    name of the serial device
  1385.                  %u -    serial device unit
  1386.                  %f -    the file  to be  transferred (or  directory in the
  1387.                          case of a batch transfer)
  1388.                  %l -    the name  of the file containing the list of files
  1389.                          to transfer (created by the BBS for sends)
  1390.                  %b -    baud rate of the  current  caller  (the  real baud
  1391.                          rate,  not  the  locked  one,  so  if you have the
  1392.                          serial port locked, don't use this)
  1393.  
  1394.                For the time being, just accept  TransCfg's defaults.   More
  1395.                information about transfer protocols will be given later.
  1396.  
  1397.                After setting  up the  transfer protocols, you will be asked
  1398.                what  formats  you  wish  to  support  for  archive viewing.
  1399.                TransAmiga allows  users to  view the contents of an archive
  1400.                in the file  areas.    You  can  support  as  many different
  1401.                archiving methods  if you  want.  Even if you do not wish to
  1402.                support archive viewing, you must setup  at least  one dummy
  1403.                method.  The default is just for viewing LHarc archives, but
  1404.                you can always allow for more, such as Zoo, Arc, etc.  As an
  1405.                example,  say  you  only  wanted  to  support viewing of Zoo
  1406.                archives.  The name of  the  archive  type  you  would enter
  1407.                would be  'Zoo'.   For the  archive suffix,  you would enter
  1408.                '.Zoo' because all Zoo  files have  that suffix,  and that's
  1409.                how TransAmiga  will recognize that a file is a Zoo archive.
  1410.                The command would be the full path name for Zoo on your disk
  1411.                plus an  'l', which is Zoo's command to look at the contents
  1412.                of an archive.  It is also possible  to use  such programmes
  1413.                as Juergen Hermann's XArc.rexx, that automatically recognize
  1414.                the archive  type.   For these  sorts of  programmes, do not
  1415.                enter a file extension.
  1416.  
  1417.                Bulletins -
  1418.                You must  set up  at least  one bulletin.   Simply enter the
  1419.                file name of each of the text files you wish to display as a
  1420.  
  1421.  
  1422.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  1423.  
  1424.  
  1425.  
  1426.  
  1427.  
  1428.           TransAmiga BBS User Manual                                Page 19
  1429.  
  1430.  
  1431.                bulletin.  Do not enter the full path name, TransAmiga looks
  1432.                for all bulletins in your bulletins directory.   The default
  1433.                is for  one Bulletin called SystemInfo, where you could just
  1434.                say a few lines about what system is  being used  to run the
  1435.                BBS.    Note  that  the  file  name  of the bulletin doesn't
  1436.                necessarily have to be the title that the user sees.  How to
  1437.                edit that is described later.
  1438.  
  1439.                You must  be careful when setting up bulletins, because each
  1440.                bulletin you set  up  will  require  its  own  entry  in the
  1441.                Bulletins.Cmds command file.  See the section on customizing
  1442.                commands later on for more details.
  1443.  
  1444.                NOTE: The CallerLog bulletin created by previous versions of
  1445.                TransAmiga is gone.
  1446.  
  1447.                Resetting User File -
  1448.                After these  files have  been setup, you will see TransCfg's
  1449.                main menu.  The last thing you must do is to reset  the user
  1450.                file, and  to create the first member of the BBS, the SysOp.
  1451.                You will be asked some questions about yourself  in order to
  1452.                create the SysOp account, then the user file will be made.
  1453.  
  1454.                Converting v1.0x User Files and File Listing -
  1455.                The last two options on TransCfg are for converting the user
  1456.                files and file  listings  of  TransAmiga  v1.0x  to  the new
  1457.                format in TransAmiga v1.1.
  1458.  
  1459.                To convert  the user  files, enter  the name  of your System
  1460.                directory that you used with  v1.0x  when  prompted.   Since
  1461.                access  flags  did  not  exist  in v1.0x, you must enter the
  1462.                flags that you wish each user to have.   Once  that is done,
  1463.                the conversion will take place automatically.
  1464.  
  1465.                NOTE:  TransAmiga  v1.1  keeps  much  more information about
  1466.                users than TransAmiga v1.0x, so some of the  new fields will
  1467.                not necessarily  have accurate  values.   For example, after
  1468.                the conversion, every user  will be  given a  postal code of
  1469.                '??? ???',  their netmail  credit will  be set to 0, and the
  1470.                full screen editor will be set as off.
  1471.  
  1472.                To convert a file listing,  simply  enter  the  path  to the
  1473.                directory,  and   TransCfg  will   convert  the  old  format
  1474.                Files.BBS file to the new format.   All  information here is
  1475.                preserved.     None  of   the  files   will  be  given  long
  1476.                descriptions, so if you would like a long  description for a
  1477.                file, you  will have to edit the .Desc file (see the section
  1478.                on file listings for details).
  1479.  
  1480.  
  1481.  
  1482.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  1483.  
  1484.  
  1485.  
  1486.  
  1487.  
  1488.           TransAmiga BBS User Manual                                Page 20
  1489.  
  1490.  
  1491.  
  1492.           Limits:
  1493.  
  1494.                TransAmiga has few built in limitations.  Theoretically, you
  1495.                should be  able to  set up 32 000 file areas, message areas,
  1496.                transfer protocols, archive viewing  methods, ARexx commands
  1497.                per menu, and bulletins.
  1498.  
  1499.                The  number  of  messages  allowed  in  a  message  area  is
  1500.                virtually unlimited, however, TransAmiga will not be able to
  1501.                keep accurate  last read  pointers for  users that have read
  1502.                past message 32768.  The number of files allowed in  an area
  1503.                is limited only by disk space
  1504.  
  1505.  
  1506.  
  1507.  
  1508.  
  1509.  
  1510.  
  1511.  
  1512.  
  1513.  
  1514.  
  1515.  
  1516.  
  1517.  
  1518.  
  1519.  
  1520.  
  1521.  
  1522.  
  1523.  
  1524.  
  1525.  
  1526.  
  1527.  
  1528.  
  1529.  
  1530.  
  1531.  
  1532.  
  1533.  
  1534.  
  1535.  
  1536.  
  1537.  
  1538.  
  1539.  
  1540.  
  1541.  
  1542.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  1543.  
  1544.  
  1545.  
  1546.  
  1547.  
  1548.           TransAmiga BBS User Manual                                Page 21
  1549.  
  1550.  
  1551.  
  1552.  
  1553.  
  1554.                                     P A R T  I I
  1555.                                     ------------
  1556.  
  1557.  
  1558.  
  1559.  
  1560.  
  1561.  
  1562.                                   Using TransAmiga
  1563.  
  1564.  
  1565.           Running TransAmiga:
  1566.  
  1567.                TransAmiga must  be started  from Shell or Workbench via the
  1568.                Release 2 Workbench Execute Cmd menu option.  It Shell usage
  1569.                is:
  1570.  
  1571.                  TransAmiga [-c<config file>] [-b<baud rate>] [-l<locked
  1572.                     baud rate] [-t<max time>] [-n<line>] [-x] [-r] [-s]
  1573.  
  1574.                Parameters  in   []  are  optional,  and  words  in  <>  are
  1575.                descriptors for what you would put  in  there.    Here  is a
  1576.                description of the parameters:
  1577.  
  1578.                -c<config file>  - This  gives the name of the master system
  1579.                configuration file you want TransAmiga to  use that TransCfg
  1580.                created.    If  it  is not given, BBS:Configs/TransAmiga.Cfg
  1581.                will be used.   TransAmiga will  not start  up if  it cannot
  1582.                find all its configuration files.
  1583.  
  1584.                -b<baud  rate>  -  This  one  is  optional.    If specified,
  1585.                TransAmiga will open up the serial port at the supplied baud
  1586.                rate  and  immediately  go  to  the  logon  sequence.   This
  1587.                parameter is used if there is already a caller online before
  1588.                TransAmiga is started.  This parameter is only really useful
  1589.                in conjunction with the -x option.
  1590.  
  1591.                -l<locked baud rate> - This parameter is also  optional, and
  1592.                tells  TransAmiga  to  lock  the serial port at the supplied
  1593.                baud rate  and do  not adjust  it.   This is  useful for HST
  1594.                users, as  locking the  baud rate  allows maximum throughput
  1595.                with those types of modems.   When used  in conjunction with
  1596.                the above  parameter, it  will over-ride that baud rate, but
  1597.                will use it as the "real" baud rate  that the  connection is
  1598.                actually at.
  1599.  
  1600.  
  1601.  
  1602.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  1603.  
  1604.  
  1605.  
  1606.  
  1607.  
  1608.           TransAmiga BBS User Manual                                Page 22
  1609.  
  1610.  
  1611.                -t<max  time>  -  Again,  an  optional parameter.  When this
  1612.                parameter is used, then the  online  time  available  of the
  1613.                next caller will be adjusted so that it is no more than this
  1614.                value.   Also, no  time bonus  will be  given after uploads.
  1615.                This parameter is only useful in conjunction with the -b and
  1616.                the -x options.
  1617.  
  1618.                -n<line>  gives  the  BBS  line  number.    If   not  given,
  1619.                TransAmiga  assumes  line  number  0.  This is only required
  1620.                when   you   wish   to   run   TransAmiga    several   times
  1621.                simultaneously.  Valid line numbers range from 0 to 99.
  1622.  
  1623.                -x -  Tells TransAmiga to exit after then next caller.  This
  1624.                useful as it allows you to perform system  maintenance tasks
  1625.                between calls with out the BBS interfering.
  1626.  
  1627.                -r  -  Tells  TransAmiga  to  wait  on  its ARexx port after
  1628.                starting up, and not logon any users.   This is particularly
  1629.                useful when having a frontend mailer answering the phone, as
  1630.                it allows nearly instantaneous transition from the mailer to
  1631.                the BBS,  instead of  having to wait for the BBS to load for
  1632.                every caller.
  1633.  
  1634.                -s - Tells TransAmiga to open the status  window as  soon as
  1635.                it loads up.  Normally you have to select an option from the
  1636.                pull-down menu to open  up the  status window.   Opening the
  1637.                status window takes up a little more precious memory.
  1638.  
  1639.                The most simple way to start up TransAmiga is:
  1640.  
  1641.                  TransAmiga
  1642.  
  1643.                If   your   configuration   file  is  something  other  than
  1644.                BBS:Configs/TransAmiga.Cfg, then you will have to pass that:
  1645.  
  1646.                  TransAmiga -cTransAmiga:Cfg/Main.Cfg
  1647.  
  1648.                In an automated environment, you will probably want  the BBS
  1649.                to exit  after every call so that you can check the time and
  1650.                see if any system events need to be run, then you'd use:
  1651.  
  1652.                  TransAmiga -cBBS:Configs/TransAmiga.Cfg -x
  1653.  
  1654.                HST users will want to lock  the  baud  rate  of  the serial
  1655.                port. So they would start the BBS up like:
  1656.  
  1657.                  TransAmiga -cBBS:Configs/TransAmiga.Cfg -l19200 -x
  1658.  
  1659.  
  1660.  
  1661.  
  1662.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  1663.  
  1664.  
  1665.  
  1666.  
  1667.  
  1668.           TransAmiga BBS User Manual                                Page 23
  1669.  
  1670.  
  1671.                Parameters  can  be  provided  in  any  order  and  are  not
  1672.                sensitive to case.
  1673.  
  1674.                When TransAmiga is  started,  it  will  open  its  window on
  1675.                either the  Workbench screen or a custom screen depending on
  1676.                how you set things up.  This window  is the  Terminal window
  1677.                and all BBS I/O is displayed here.  You can also open up the
  1678.                status window from either the pull-down menu or using the -s
  1679.                command line  option, which  is used  to display information
  1680.                about the current online caller.
  1681.  
  1682.  
  1683.           Troubleshooting:
  1684.  
  1685.                If TransAmiga does not come up  and say  that it  is waiting
  1686.                for a  call when you try to start it up, something is set up
  1687.                wrong.
  1688.  
  1689.                TransAmiga  will  give  you  an  error  message  which  will
  1690.                hopefully be enough for you to figure out what is wrong.  If
  1691.                it's a problem in either a config file or a command file, it
  1692.                will tell you which file has the problem, then you will have
  1693.                to either load the file up in TransCfg  or in  a text editor
  1694.                as the case may be.  Probably the most common problem is not
  1695.                adding  command  entries  to  the  Bulletin.Cmds   file  for
  1696.                bulletins that you created in TransCfg.
  1697.  
  1698.                If a  requester or  even worse, an alert appears, then there
  1699.                may be a more  serious  problem.    Please  check  seek some
  1700.                support to figure out what the problem is.
  1701.  
  1702.  
  1703.           Pull-Down Menus:
  1704.  
  1705.                TransAmiga   has   two   standard   Amiga  pull-down  menus:
  1706.                "TransAmiga", and "User".  The latter is only available when
  1707.                there is  someone logged  on, and many of the items from the
  1708.                former are disabled when users are online.
  1709.  
  1710.                Commands in the TransAmiga menu  allow  you  to  do  a local
  1711.                (SysOp)  logon,  open  or  close  the status window, enter a
  1712.                simple  terminal  mode,  resend  your  modem  initialization
  1713.                string, get  some information  about TransAmiga, and to quit
  1714.                the programme altogether.
  1715.  
  1716.                The User menu allows you to  go  into  "chat"  mode  with an
  1717.                online user,  edit a  user's access  and information, and to
  1718.                automatically log off an online user immediately.
  1719.  
  1720.  
  1721.  
  1722.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  1723.  
  1724.  
  1725.  
  1726.  
  1727.  
  1728.           TransAmiga BBS User Manual                                Page 24
  1729.  
  1730.  
  1731.  
  1732.           TransAmiga Online:
  1733.  
  1734.                After TransAmiga starts, it must do some initialization.  It
  1735.                must load  the config files, and the command files, etc.  If
  1736.                you did not tell it to immediately try  to log  on a caller,
  1737.                then it will scan the message areas.  If you did, TransAmiga
  1738.                does not scan the message areas until after a user logs on.
  1739.  
  1740.                Depending on how you started TransAmiga, it will either wait
  1741.                for  a  caller,  wait  for  an ARexx message, or immediately
  1742.                attempt to logon an already online  user.   If it  is either
  1743.                waiting for a call, or waiting for an ARexx message, you can
  1744.                logon yourself by  selecting  "Local  Logon"  from  the menu
  1745.                strip.
  1746.  
  1747.                If you are unregistered, a requester will come up as soon as
  1748.                the BBS starts giving  the copyright  notice.   After delay,
  1749.                you can just click the mouse button to make it disappear.
  1750.  
  1751.  
  1752.           Logging On:
  1753.  
  1754.                Before anything  can be done, a user must logon.  You can do
  1755.                this from the machine  running TransAmiga  but selecting the
  1756.                Local  Logon  item  from  the  pull-down  menu.    The logon
  1757.                consists of first entering you user name.   If this  is your
  1758.                first time running TransAmiga, enter the SysOp user name and
  1759.                password that you set up with TransCfg.  If a new user calls
  1760.                and  wishes  to  logon  to  your system, he/she should enter
  1761.                their name at this prompt.  TransAmiga will see that they do
  1762.                not have  an account  on the BBS, and will take them through
  1763.                the new user procedure.  Users  that have  set a  handle for
  1764.                themselves  (if  handles  are  allowed)  may  also use their
  1765.                handle to logon.
  1766.  
  1767.                After entering the user name, and if the user is not a first
  1768.                time  caller,  a  password  must  be entered.  You get three
  1769.                tries at the password, and what you type  will be  hidden so
  1770.                that onlookers will not be able to determine your password.
  1771.  
  1772.  
  1773.           BBS Menus:
  1774.  
  1775.                At last, the Main Menu is presented.  As with most BBS's, in
  1776.                TransAmiga the user performs functions by  making selections
  1777.                from menus.   Sometimes  making a selection from a menu will
  1778.                take you to another menu.  In this  way, the  menu structure
  1779.  
  1780.  
  1781.  
  1782.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  1783.  
  1784.  
  1785.  
  1786.  
  1787.  
  1788.           TransAmiga BBS User Manual                                Page 25
  1789.  
  1790.  
  1791.                is similar  to a tree.   Here's how the tree branches out in
  1792.                TransAmiga:
  1793.  
  1794.  
  1795.                                       Main Menu
  1796.                                            |
  1797.                      +----------+----------+----------+----------+
  1798.                      |          |          |          |          |
  1799.                   Messages    File     Bulletin   Settings    Extras
  1800.                     Menu      Menu       Menu       Menu       Menu
  1801.  
  1802.  
  1803.                Here is a summary of all the menus in TransAmiga.  To  get a
  1804.                more  detailed  description  of the commands available, look
  1805.                through the supplied Help files in the text directory.
  1806.  
  1807.                Main Menu - From here the  user can  get to  the other menus
  1808.                available from the system.  These menus are the Change Setup
  1809.                Menu, the Message Menu,  the File  Menu, the  Bulletin Menu,
  1810.                and the Extras Menu.
  1811.  
  1812.                Message  Menu  -  This  is  where  users  can read and write
  1813.                messages to and from other users.  Message areas can  be set
  1814.                up as either traditional local message areas, FidoNet matrix
  1815.                mail areas, or FidoNet  echomail  areas.    Messages  can be
  1816.                either  public  which  can  be  viewed by all, or privileged
  1817.                which may only be read by the person who wrote  the message,
  1818.                the  person  who  the  message  is  sent  to, and those with
  1819.                special  access.    The  Message  Menu  is  divided  up into
  1820.                multiple  message  areas.    Each  area is isolated from the
  1821.                others and requires a  certain SysOp  defined minimum access
  1822.                to get to.
  1823.  
  1824.                Files Menu - The file areas work in a fashion similar to the
  1825.                message areas in that each area is isolated from the others,
  1826.                and requires  a certain minimum access.  Here is where users
  1827.                can send and receive files to and from  the BBS.   Each user
  1828.                has  his  own  Upload:Download  ratio,  which means that for
  1829.                every specified number of downloads the  user must  upload a
  1830.                file.  If  you  do  not  wish  to  implement this, it can be
  1831.                side-stepped easily.
  1832.  
  1833.                Bulletins Menu - This  menu is  for posting  text files that
  1834.                users can  read.   Things you might want to post include BBS
  1835.                listing for  the area,  rules of  the BBS,  online game high
  1836.                scores, etc.
  1837.  
  1838.                Settings Menu - This is where the user can enter information
  1839.  
  1840.  
  1841.  
  1842.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  1843.  
  1844.  
  1845.  
  1846.  
  1847.  
  1848.           TransAmiga BBS User Manual                                Page 26
  1849.  
  1850.  
  1851.                about his/herself, and also adjust some  global settings for
  1852.                BBS use, such as password, screen length, etc.
  1853.  
  1854.                Extras Menu  - As  it says, this is just an extra menu.  You
  1855.                would use this to add  ARexx  commands  to,  such  as online
  1856.                games.
  1857.  
  1858.  
  1859.           Entering Commands:
  1860.  
  1861.                TransAmiga  gives  users  two  modes of entering commands at
  1862.                menus: command-stacking and hotkeyed commands.
  1863.  
  1864.                Hotkeyed commands (or just  hotkeys) means  that the command
  1865.                is processed  the second  the user presses the corresponding
  1866.                key, RETURN does not  have to  be pressed.   This  of course
  1867.                cannot  be  the  case  when  text the user is entering is of
  1868.                variable length, for example, a message conference number or
  1869.                their street  address, so  RETURN must be pressed at the end
  1870.                of the line.
  1871.  
  1872.                Command stacking allows the  user to  enter several commands
  1873.                on one  line, one immediately after the other.  For example,
  1874.                typing in "c?" at the Main Menu will  bring take  you to the
  1875.                Change  Setup  Menu  (c)  and display the available commands
  1876.                (?).  You can stack as many commands as you want on a single
  1877.                line.   In cases  where you'd normally have to press RETURN,
  1878.                you can instead enter a space, eg. M12 N from  the Main Menu
  1879.                will take you the Message Menu (M), go to conference 12 (12,
  1880.                followed by space because you would  need to  normally press
  1881.                RETURN at this point), and read new messages (N).
  1882.  
  1883.                TransAmiga offers  special command  line editing features to
  1884.                those with ANSI turned.   You  may  use  the  backspace, the
  1885.                delete key,  and the  left and right cursor keys to edit the
  1886.                line  you  are  entering,  just  like  in  the   CLI  Shell.
  1887.                Additionally, you  may call  back commands you've previously
  1888.                entered and edit them  by  pressing  CTRL-K,  and  to simply
  1889.                clear any  text you  typed on the current line, press CTRL-X
  1890.                (NOTE: These last two work with ANSI turned off as well).
  1891.  
  1892.  
  1893.  
  1894.  
  1895.  
  1896.  
  1897.  
  1898.  
  1899.  
  1900.  
  1901.  
  1902.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  1903.  
  1904.  
  1905.  
  1906.  
  1907.  
  1908.           TransAmiga BBS User Manual                                Page 27
  1909.  
  1910.  
  1911.                                     Text Editors
  1912.  
  1913.  
  1914.           BBS Text Editors:
  1915.  
  1916.                At various times when  using the  BBS, a  user will  wish to
  1917.                enter a  relatively large  amount of text, for example, when
  1918.                entering a message, or  leaving  a  long  description  for a
  1919.                file.   To make  the entering of text as simple as possible,
  1920.                TransAmiga provides a variety  of  text  editor  options for
  1921.                users.   There are  actually three different sets of editors
  1922.                that can be used, depending on the circumstances:  the built
  1923.                in line editor; the external ANSI full-screen editor, called
  1924.                TrEd; and a local editor of your choice.
  1925.  
  1926.  
  1927.           The Line Editor:
  1928.  
  1929.                The built in line editor,  called  TransEd  is  the simplest
  1930.                type of  editor, included  for mainly for those without ANSI
  1931.                graphics capabilities.  A user enters text continually.   At
  1932.                the  end  of  a  line  there  is  no need to press RETURN as
  1933.                TransEd will wrap words automatically.
  1934.  
  1935.                In the  line editor  version of  TransEd you  can not cursor
  1936.                back to edit something you may have entered incorrectly, you
  1937.                must use the backspace  key and  delete everything  you have
  1938.                entered since the mistake.  You may only backspace as far as
  1939.                the beginning of your current line, you cannot go back  to a
  1940.                previous line.
  1941.  
  1942.                Several commands  are available  in TransEd and are accessed
  1943.                by preceding them with the backslash '\' character  and must
  1944.                be  the  first  thing  entered  on  a  new line, followed by
  1945.                RETURN.  Entering a \ by  itself will  take you  to the edit
  1946.                menu  where  you  will  be  able  to  get  a menu of all the
  1947.                available commands.  There are  commands  to  view  what you
  1948.                have entered  so far,  to save  your text, to abort what you
  1949.                were doing, to change a string on a line of text, etc.
  1950.  
  1951.  
  1952.           The Full-Screen Editor:
  1953.  
  1954.                The full-screen editor, TrEd, provides much  more power than
  1955.                the line  editor.   You can  use the cursor keys to move all
  1956.                around the text being  edited.    Attempting  to  type where
  1957.                there is  already text,  causes everything on the line to be
  1958.                moved forward a space to make room for what you  are typing.
  1959.                It acts  much more like a conventional editor that you would
  1960.  
  1961.  
  1962.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  1963.  
  1964.  
  1965.  
  1966.  
  1967.  
  1968.           TransAmiga BBS User Manual                                Page 28
  1969.  
  1970.  
  1971.                use.  The added power comes at the cost of compatibility, as
  1972.                TrEd must  rely heavily  on ANSI  control sequences, so only
  1973.                users that have ANSI terminals may use TrEd.
  1974.  
  1975.                Most commands understood by TrEd are  combinations of either
  1976.                holding Control and pressing a key, or pressing Escape, then
  1977.                pressing another key.  For  example,  to  view  the  list of
  1978.                commands, press  the Escape key, then press ?.  To save what
  1979.                you are writing, hold Control and press Z.
  1980.  
  1981.                Care must be taken when using TrEd.  First of  all, it makes
  1982.                very  extensive  use  of  ANSI  control  sequences, and many
  1983.                terminals do  not  have  all  the  necessary  commands fully
  1984.                implemented.      For   example,   certain  MS-DOS  terminal
  1985.                programmes have  difficulties with  some of  the codes sent.
  1986.                Most  Amiga  terminals,  however,  will  work just fine with
  1987.                TrEd.    You  should  note  that  TrEd  adjusts  its display
  1988.                depending on  the screen  size of the caller.  Therefore, if
  1989.                the current caller has his/her screen length set larger than
  1990.                what will  fit in  your terminal  window, TrEd's display may
  1991.                not look right to you.    Rest  assured,  that  provided the
  1992.                user's screen length is set correctly, it will look fine for
  1993.                him/her.
  1994.  
  1995.                NOTE: A full-screen editor  can only  be used  if you  are a
  1996.                registered TransAmiga user.
  1997.  
  1998.  
  1999.           Local Editor:
  2000.  
  2001.                TransAmiga also allows you to set the editor to use in local
  2002.                mode.  Unlike the  line editor  and the  full-screen editor,
  2003.                this editor  does not  have to  be designed for use over the
  2004.                serial port.  All  it needs  to do  is to  save the finished
  2005.                text under  the appropriate  name, which can be passed using
  2006.                %f as a part of your editor command.  If  you wish  to quote
  2007.                lines when  replying, the  quote buffer  is held in the file
  2008.                passed using %q.  Most editors  have the  ability to execute
  2009.                macros on startup, so you may wish to create a startup macro
  2010.                for use with TransAmiga that inserts the quote buffer at the
  2011.                top of the message text.
  2012.  
  2013.                Note that  there are  some problems  with editors that auto-
  2014.                detach  themselves  from  their  parent  CLI   process  (eg.
  2015.                CygnusEd  Professional).    TransAmiga  will think that they
  2016.                have exited  almost as  soon as  you run  them, because they
  2017.                return immediately.   Luckily, most editors that auto-detach
  2018.                like this have an option to over-ride this, so that  they do
  2019.  
  2020.  
  2021.  
  2022.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  2023.  
  2024.  
  2025.  
  2026.  
  2027.  
  2028.           TransAmiga BBS User Manual                                Page 29
  2029.  
  2030.  
  2031.                not return until they have exited.  You will need to consult
  2032.                your editor's manual on this.
  2033.  
  2034.  
  2035.           Reply Quoting:
  2036.  
  2037.                When replying to a message TransAmiga  allows anyone  of the
  2038.                three editor  types to insert quoted lines from the original
  2039.                message into the text.   In  the  line  editor,  entering \V
  2040.                allows you  to view  the lines  in the  quote buffer, and \Q
  2041.                allows you to insert them.  In the  TrEd, you  press CTRL-Q,
  2042.                which opens up the quote window.  With the local editor, you
  2043.                may need to write some scripts or macros to load  the quoted
  2044.                text into the editor.
  2045.  
  2046.                At the  beginning of  the quote  buffer is  always the quote
  2047.                lead-in line as you setup in TransCfg for that message area.
  2048.                It is  usually good  practice to  insert this line into your
  2049.                message right before you quote any  actual message  text, as
  2050.                it  tells  people  reading  the message exactly what you are
  2051.                about to quote.
  2052.  
  2053.  
  2054.  
  2055.  
  2056.  
  2057.  
  2058.  
  2059.  
  2060.  
  2061.  
  2062.  
  2063.  
  2064.  
  2065.  
  2066.  
  2067.  
  2068.  
  2069.  
  2070.  
  2071.  
  2072.  
  2073.  
  2074.  
  2075.  
  2076.  
  2077.  
  2078.  
  2079.  
  2080.  
  2081.  
  2082.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  2083.  
  2084.  
  2085.  
  2086.  
  2087.  
  2088.           TransAmiga BBS User Manual                                Page 30
  2089.  
  2090.  
  2091.                                     Access Levels
  2092.  
  2093.  
  2094.           User Access:
  2095.  
  2096.                TransAmiga has 256 different  access levels  numbered from 0
  2097.                to 255.  Access levels are useful for a variety of purposes.
  2098.                For  example,  allowing  assistant  SysOps  access   to  BBS
  2099.                maintenance functions,  restricting new non-validated users,
  2100.                etc.
  2101.  
  2102.  
  2103.           Access Flags:
  2104.  
  2105.                Access  flags  are  a  second  level  of  access  control in
  2106.                TransAmiga.   The BBS is designed such that the access level
  2107.                should be used as the primary means for  controlling access,
  2108.                but access flags give an additional level of control.
  2109.  
  2110.                Access flags are a set of eight "flags".  For a user to have
  2111.                access to, for example, a  certain  file  area,  he/she must
  2112.                have at  least the  same flags  set as are required for that
  2113.                file area.  For example, say the flags for that area are:
  2114.  
  2115.                  X--XX----
  2116.                  (X's indicate the flag is set, -'s indicate it is unset)
  2117.  
  2118.                Now, a user with flags:
  2119.  
  2120.                  X---X-X---
  2121.  
  2122.                would not have access, because not  all the  necessary flags
  2123.                are set;  the fact  that he has another extra flag set is of
  2124.                no consequence in this  situation.    However,  a  user with
  2125.                flags:
  2126.  
  2127.                  X--XX--X-
  2128.  
  2129.                would have access, since all the necessary flags are set.
  2130.  
  2131.  
  2132.           New Users:
  2133.  
  2134.                When a user logs on for the very first time, he/she is given
  2135.                access 0 which denotes a user who has just logged  on.  This
  2136.                user is  known as  a "Guest", one who has just logged on and
  2137.                is  looking  around.    Therefore,  generally  speaking, the
  2138.                functions  that  a  guest  should  have access too should be
  2139.                quite limited.   You  should  never  manually  set  a user's
  2140.  
  2141.  
  2142.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  2143.  
  2144.  
  2145.  
  2146.  
  2147.  
  2148.           TransAmiga BBS User Manual                                Page 31
  2149.  
  2150.  
  2151.                access to  0, as this will be considered by TransAmiga to be
  2152.                a deleted user.  1 is the lowest access level.
  2153.  
  2154.                If the guest wishes to become  a member  of the  BBS, he/she
  2155.                must select the command to join the BBS.  Upon completion of
  2156.                this questionnaire,  the user  receives the  new user access
  2157.                level,  time  limit,  and  upload  download ratio.  How much
  2158.                access is given to  this kind  of user  depends on  your own
  2159.                preferences.   Remember it is still that person's first call
  2160.                and you have not  had a  chance to  validate him/her.   Some
  2161.                people  like  to  run  an  open  system  and give first time
  2162.                callers full validated access,  while others  prefer to keep
  2163.                them restricted.
  2164.  
  2165.  
  2166.           Privileged Access:
  2167.  
  2168.                Privileged  access  is  anything  equal to or above what you
  2169.                defined as privileged access in TransCfg.
  2170.  
  2171.                You should be very careful whom  you give  privileged access
  2172.                to.    Generally  speaking,  in  addition  to yourself there
  2173.                should only  be  one  or  two  more  people  with privileged
  2174.                access.
  2175.  
  2176.  
  2177.           A Note on Users' Rights:
  2178.  
  2179.                Human  rights   granted  to   people  differs  in  different
  2180.                countries.   In  most  countries  though,  everyone  must be
  2181.                granted  access  to  your  BBS,  even  if  you wish to run a
  2182.                private system.  You may  not  discriminate  against  a user
  2183.                because of  race, sex,  age, etc.  nor may  you limit any of
  2184.                their other rights.  The law still applies in the BBS world!
  2185.  
  2186.  
  2187.  
  2188.  
  2189.  
  2190.  
  2191.  
  2192.  
  2193.  
  2194.  
  2195.  
  2196.  
  2197.  
  2198.  
  2199.  
  2200.  
  2201.  
  2202.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  2203.  
  2204.  
  2205.  
  2206.  
  2207.  
  2208.           TransAmiga BBS User Manual                                Page 32
  2209.  
  2210.  
  2211.                                        TrMaint
  2212.  
  2213.  
  2214.           User Maintenance:
  2215.  
  2216.                Unlike  other  BBS  packages  (including  TransAmiga v1.0x),
  2217.                TransAmiga  v1.1  does  not  have  a  built  in  SysOp menu.
  2218.                Instead, it has a separate  utility  called  TrMaint.   This
  2219.                actually works  better than having a built in SysOp menu, as
  2220.                it  removes  code  from  the  main  programme  that  is only
  2221.                actually  used  by  one  or  two users of a BBS, thus saving
  2222.                memory and cutting loading time.   It is  also advantageous,
  2223.                as TrMaint  can be  run not  only through the BBS as a door,
  2224.                but also from the AmigaDOS  shell,  thus  providing  a full-
  2225.                featured offline user maintenance utility.
  2226.  
  2227.  
  2228.           Running TrMaint as a Door:
  2229.  
  2230.                To install  TrMaint as  a door from within the BBS, you will
  2231.                have to create an  ARexx macro  that starts  it up  (see the
  2232.                section on ARexx on how to go about this).  The sole purpose
  2233.                of this  macro will  be to  send the  appropriate command to
  2234.                AmigaDOS to start up TrMaint.  This command is:
  2235.  
  2236.                  TrMaint -c<config file> -n<line number>
  2237.  
  2238.                Where <config  file> is  the same one that you used to start
  2239.                TransAmiga with, and -n  is the  number identified  with the
  2240.                current BBS  line (this  will always  be 0  in a single line
  2241.                system).  This last parameter must be provided,  as it tells
  2242.                TrMaint  that  it  will  be  running through the BBS and not
  2243.                through the CLI.
  2244.  
  2245.  
  2246.           Running TrMaint from CLI:
  2247.  
  2248.                This is done in much the same way as described above, except
  2249.                that you  do not pass the BBS line number.  Leaving this out
  2250.                tells TrMaint that it should use  the current  CLI.   All of
  2251.                the  same  functions  are  available  regardless  of whether
  2252.                TrMaint is run from the CLI or through  the BBS,  except for
  2253.                the fact that TrMaint can only be "multi-line friendly" when
  2254.                being run from the BBS, so TrMaint should  only be  run from
  2255.                CLI when there are no users currently online.
  2256.  
  2257.  
  2258.           Sample ARexx Macro:
  2259.  
  2260.  
  2261.  
  2262.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  2263.  
  2264.  
  2265.  
  2266.  
  2267.  
  2268.           TransAmiga BBS User Manual                                Page 33
  2269.  
  2270.  
  2271.                This is  an example of the type of ARexx macro you would use
  2272.                for starting TrMaint as a door from the BBS.
  2273.  
  2274.                  /* TrMaint.trans, starts TrMaint */
  2275.  
  2276.                  options results
  2277.  
  2278.                  /* Find out what line we're coming from, and what config
  2279.                   * file this line is using.
  2280.                   */
  2281.                  SYSTEMINFO 8 ; bbsline=result
  2282.                  SYSTEMINFO 9 ; cfgfile=result
  2283.  
  2284.                  PRINT 'Entering the SysOp Maintenance module...'
  2285.                  NEWLINE
  2286.  
  2287.                  /* Start up TrMaint by sending the proper command */
  2288.                  address command 'BBS:Bin/TrMaint -c'cfgfile' -n'bbsline
  2289.  
  2290.                  exit
  2291.  
  2292.  
  2293.  
  2294.  
  2295.  
  2296.  
  2297.  
  2298.  
  2299.  
  2300.  
  2301.  
  2302.  
  2303.  
  2304.  
  2305.  
  2306.  
  2307.  
  2308.  
  2309.  
  2310.  
  2311.  
  2312.  
  2313.  
  2314.  
  2315.  
  2316.  
  2317.  
  2318.  
  2319.  
  2320.  
  2321.  
  2322.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  2323.  
  2324.  
  2325.  
  2326.  
  2327.  
  2328.           TransAmiga BBS User Manual                                Page 34
  2329.  
  2330.  
  2331.                                    File Transfers
  2332.  
  2333.  
  2334.           File Listings:
  2335.  
  2336.                TransAmiga  keeps  a  file  called  Files.BBS  in  each file
  2337.                directory.    This  file  contains all necessary information
  2338.                about each online file to display the file  listing and file
  2339.                information.   It is an ASCII text file.  Each line contains
  2340.                one file entry.
  2341.  
  2342.                The first field is the name of the file.  This is convenient
  2343.                because you  can easily alphabetize your file listings using
  2344.                the AmigaDOS Sort command.
  2345.  
  2346.                When the file listing is  being  displayed  from  within the
  2347.                BBS, you  may wish  to have  certain comments displayed with
  2348.                the file listing.  To do this, using  a text  editor, simply
  2349.                type in the text you want to have displayed, but have as the
  2350.                first character on the line be a backslash (\).   You can do
  2351.                this anywhere within Files.BBS and it will still work.  When
  2352.                a user goes to  list the  files, all  lines within Files.BBS
  2353.                that begin  with a \ will be displayed as straight text.  If
  2354.                this   text   contains   ANSI   sequence,   TransAmiga  will
  2355.                automatically strip them for callers without ANSI.
  2356.  
  2357.                Here's an example of what you could put in File.bbs:
  2358.  
  2359.                  \  +++++++++++++++++++++++++++++++++++
  2360.                  \  ++         AMIGA UTILITIES       ++
  2361.                  \  +++++++++++++++++++++++++++++++++++
  2362.                  \
  2363.                  \NOTE: All files have been compressed with LHA.
  2364.  
  2365.                These   lines   will   be   displayed   as-is  (without  the
  2366.                backslashes) whenever the user gets a file listing  for that
  2367.                area.   Note the  lone backslash  on a line for displaying a
  2368.                blank line.
  2369.  
  2370.  
  2371.           Long Descriptions:
  2372.  
  2373.                In  TransAmiga  v1.1,  users   can  optionally   enter  long
  2374.                descriptions of  files they  have uploaded.  These files are
  2375.                stored  in  the  file  library  directory   under  the  name
  2376.                <filename>.Desc.   For example, if the file LHA_1111.Run was
  2377.                uploaded,  its  long  description  would  go   in  the  file
  2378.                LHA_111.Run.Desc.   Even if  a user  doesn't give the file a
  2379.                long description, a .Desc file will  still be  created.  The
  2380.  
  2381.  
  2382.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  2383.  
  2384.  
  2385.  
  2386.  
  2387.  
  2388.           TransAmiga BBS User Manual                                Page 35
  2389.  
  2390.  
  2391.                first line of every .Desc file contains the name of the user
  2392.                that uploaded it (or that user's handle, if he/she has one).
  2393.                Every subsequent line is part of the description text.  This
  2394.                is basically like any ASCII text  file so  it can  be edited
  2395.                outside of the BBS with a text editor.
  2396.  
  2397.  
  2398.           Types of Transfers:
  2399.  
  2400.                There  are  3  kinds  of  file transfer modes in TransAmiga:
  2401.                batch, local and normal.  A local transfer can be  done only
  2402.                when you  are logged  on locally, and there is no such thing
  2403.                as a local download, only  local  upload.    Batch transfers
  2404.                allow  you  to  specify  several  files at once to transfer.
  2405.                With normal transfers you must  specify  one  transfer  at a
  2406.                time.   Local uploads  are done  when the SysOp would like a
  2407.                file he/she has placed in a file area directory to appear in
  2408.                the  file  listing.    Batch transfers are used by protocols
  2409.                such as Zmodem (see the section on TransCfg to find  out how
  2410.                to designate  a protocol as batch). Normal transfers are for
  2411.                all other protocols (Xmodem, Jmodem, etc.).
  2412.  
  2413.  
  2414.           TrXPR:
  2415.  
  2416.                TrXPR is an  external  programme  that  TransAmiga  uses for
  2417.                performing  file  transfers.    It  uses  the  XPR  transfer
  2418.                protocol  libraries,  which  is   a  standardized   way  for
  2419.                implementing transfer  protocols on  the Amiga using shared-
  2420.                libraries.  When you first setup  TransAmiga, you  were told
  2421.                to simply  except TransCfg's default protocol commands.  All
  2422.                of these used TrXPR and XPR libraries.
  2423.  
  2424.                TrXPR will now be explained in a little more detail, so that
  2425.                you  will  be  able  to further customize your file transfer
  2426.                commands.  TrXPR has the following command line usage:
  2427.  
  2428.                  TrXPR <line> <protocol> <init> R|S <filelist>|<files...>
  2429.  
  2430.                <line> indicates which BBS line number wants to  perform the
  2431.                transfer.    You  should  use  %n  here,  so that TransAmiga
  2432.                substitutes the correct line number.
  2433.  
  2434.                <protocol> is the name of the protocol library  to use minus
  2435.                the  'xpr'  prefix  and  the  '.library'  suffix.   So for a
  2436.                protocol that is to  use  the  xprzmodem.library,  you would
  2437.                just enter 'zmodem'.
  2438.  
  2439.  
  2440.  
  2441.  
  2442.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  2443.  
  2444.  
  2445.  
  2446.  
  2447.  
  2448.           TransAmiga BBS User Manual                                Page 36
  2449.  
  2450.  
  2451.                <init> is the library initialization string.  The meaning of
  2452.                this is dependent on each library.   Every  library has it's
  2453.                own set of parameters that can be included here, so you will
  2454.                have to consult the library's documentation to find out what
  2455.                to put here.
  2456.  
  2457.                R|S tells where you want to do a Send or a Receive.
  2458.  
  2459.                <filelist> is  the name  of a  file that  contains a list of
  2460.                files to be sent.
  2461.                <files...> is the name  of the  files to  be received.   How
  2462.                this field is treated depends on the library.  With most, it
  2463.                will just be interpreted  as the  filenames for  files to be
  2464.                sent  or   received.    However,  some  libraries  treat  it
  2465.                differently.   For  example,  the  xprzmodem.library ignores
  2466.                this field when doing a receive.
  2467.  
  2468.                TrXPR expects  the <filelist>  argument when the S option is
  2469.                used, and <files...> when the R option is used.
  2470.  
  2471.                TransCfg's defaults are  for  Xmodem  and  Zmodem protocols.
  2472.                There are other libraries available, which will allow you to
  2473.                set up Ymodem, Kermit, CIS B+, Jmodem, and  other protocols.
  2474.                Using TrXPR, getting these to work with TransAmiga should be
  2475.                quite simple.
  2476.  
  2477.  
  2478.           File Credit:
  2479.  
  2480.                One option  in  TransAmiga  is  file  upload:download ratio.
  2481.                That is,  for every so many files the user downloads, he/she
  2482.                must upload  one file  and will  not be  allowed to download
  2483.                again until he/she has done so.
  2484.  
  2485.                This  is  the  only  limitation  imposed  on  a  user's file
  2486.                transfers.  TransAmiga does keep track  of the  total amount
  2487.                of bytes a user has transferred, but TransAmiga does not use
  2488.                this.
  2489.  
  2490.  
  2491.  
  2492.  
  2493.  
  2494.  
  2495.  
  2496.  
  2497.  
  2498.  
  2499.  
  2500.  
  2501.  
  2502.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  2503.  
  2504.  
  2505.  
  2506.  
  2507.  
  2508.           TransAmiga BBS User Manual                                Page 37
  2509.  
  2510.  
  2511.  
  2512.  
  2513.  
  2514.  
  2515.                                    P A R T  I I I
  2516.                                    --------------
  2517.  
  2518.  
  2519.  
  2520.  
  2521.  
  2522.  
  2523.                                 TransAmiga Multi-Line
  2524.  
  2525.  
  2526.           About Multi-Line:
  2527.  
  2528.                A multi-line BBS system is  simply  a  BBS  that  has modems
  2529.                hooked up  to multiple  phone lines,  so that  it can handle
  2530.                more than one caller at the same time.  This  is about where
  2531.                the  simplicity  of  multi-line  ends, as there are numerous
  2532.                complexities.
  2533.  
  2534.                What makes multi-line so  complex is  the fact  that the BBS
  2535.                must  some   how  arbitrate  access  to  its  resources,  as
  2536.                inevitably two users on different lines will want to perform
  2537.                operations  that  conflict  with  each  other.  For example,
  2538.                trying to read a message that is currently  being saved, and
  2539.                downloading a  file that  is still  in the  process of being
  2540.                uploaded.  TransAmiga makes sure that  when it  wants access
  2541.                to  something,  that  another  copy  of  TransAmiga  already
  2542.                running is not trying to access it at the same time.
  2543.  
  2544.  
  2545.           Setting Up Multi-Line:
  2546.  
  2547.                Multi-line is  setup  in  TransAmiga  simply  by  creating a
  2548.                separate  master  system  configuration  file for each line.
  2549.                All  other  files,  including   other  configuration  files,
  2550.                messages,  bulletins,  text  files,  etc.  can  be shared by
  2551.                multiple lines.  So you do not have to configure the message
  2552.                areas  for  each  line,  you  do  not  need  a separate text
  2553.                directory for each line, etc.  Only the master configuration
  2554.                files need be different.
  2555.  
  2556.                If however,  you do want certain things to be different, you
  2557.                may.  For example, perhaps you want one line of  your BBS to
  2558.                serve MS-DOS  users, and the other to serve Amiga users, you
  2559.                could have different  file  and  message  configurations for
  2560.  
  2561.  
  2562.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  2563.  
  2564.  
  2565.  
  2566.  
  2567.  
  2568.           TransAmiga BBS User Manual                                Page 38
  2569.  
  2570.  
  2571.                each line.   Or  perhaps, if you wanted to require a fee for
  2572.                access to your additional lines, you would have  a different
  2573.                users  directory  for  only  those users with access to that
  2574.                line.
  2575.  
  2576.                Usually, most of each of the master configuration files will
  2577.                end up  being the  same.  Generally speaking, only the modem
  2578.                configuration will  differ.   Most likely  the serial device
  2579.                name and/or  the unit  number will be different, and perhaps
  2580.                the baud rates and modem commands  will need  to be altered.
  2581.                Perhaps  you  may  want  your  screen configurations to be a
  2582.                little different also.
  2583.  
  2584.                To actually run the  other  BBS  lines,  you  just  start up
  2585.                TransAmiga  several  times,  specifying  a  different master
  2586.                configuration  file  each  time,   and  also   specifying  a
  2587.                different number  using the  -n command line parameter.  For
  2588.                example, if you ran  two lines  on your  BBS, you  might use
  2589.                these two commands to start up the two lines:
  2590.  
  2591.                  TransAmiga -cBBS:Configs/TransAmiga_0.Cfg -n0
  2592.                  TransAmiga -cBBS:Configs/TransAmiga_1.Cfg -n1
  2593.  
  2594.                Notice  how  a  different configuration files was specified,
  2595.                and how  the  -n  parameter  was  used  to  give  the second
  2596.                invocation of  TransAmiga a line number of 1.  For each line
  2597.                you setup,  you must  be certain  that these  two things are
  2598.                unique.
  2599.  
  2600.                Remember also  that TransAmiga  is safe to be made resident.
  2601.                If you are regularly keeping more than one  line running, it
  2602.                will  save  you  more  memory  by  first  making  TransAmiga
  2603.                resident.
  2604.  
  2605.  
  2606.           Running a Local-Only Line:
  2607.  
  2608.                TransAmiga has  the useful  ability to  designate a separate
  2609.                line for  local use only.  Even though you may actually only
  2610.                have one line available for online callers, you can set up a
  2611.                second line  that you  can use locally, thus allowing you to
  2612.                log onto your board even if there is already a user online.
  2613.  
  2614.                All that needs to be done is to have the name of your serial
  2615.                device  blank.    All  other  modem  related  fields will be
  2616.                ignored, and that  BBS  line  will  not  be  able  to accept
  2617.                callers.  The only way to logon will be locally.
  2618.  
  2619.  
  2620.  
  2621.  
  2622.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  2623.  
  2624.  
  2625.  
  2626.  
  2627.  
  2628.           TransAmiga BBS User Manual                                Page 39
  2629.  
  2630.  
  2631.           Other Programmes and Multi-Line:
  2632.  
  2633.                Remember  our  discussion  about  conflicts  that inevitably
  2634.                arise when running a multi-line system?  TransAmiga  has the
  2635.                arbitration  capabilities  built-in,  but  it cannot control
  2636.                what other external programmes do.    You  have  to  be very
  2637.                careful  when  running  multi-line,  that you only use doors
  2638.                that are "multi-line" friendly.
  2639.  
  2640.                For  example,  an  online  game  that   created  a  bulletin
  2641.                containing the  scores of the various players, would have to
  2642.                some how ensure that another  invocation  of  the  same door
  2643.                isn't  writing  to  that  file  at  the same time.  A simple
  2644.                solution for this is to just  create a  file of  a different
  2645.                name for  each line.   Another  possibility would be to have
  2646.                the programme to make it's  presence  known,  and  not allow
  2647.                multiple copies of itself to be running at the same time.  A
  2648.                more elegant solution would  to  have  a  locking mechanisms
  2649.                (using the  Amiga's semaphores  is a  very easy way of doing
  2650.                this) to lock access  to  certain  resources  when  they are
  2651.                being used.
  2652.  
  2653.                Having  doors   that  aren't   multi-line  friendly  running
  2654.                simultaneously on multiple lines is extremely dangerous.  In
  2655.                the worst  instances, it  could create corrupt files on your
  2656.                drive, so be careful.
  2657.  
  2658.  
  2659.  
  2660.  
  2661.  
  2662.  
  2663.  
  2664.  
  2665.  
  2666.  
  2667.  
  2668.  
  2669.  
  2670.  
  2671.  
  2672.  
  2673.  
  2674.  
  2675.  
  2676.  
  2677.  
  2678.  
  2679.  
  2680.  
  2681.  
  2682.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  2683.  
  2684.  
  2685.  
  2686.  
  2687.  
  2688.           TransAmiga BBS User Manual                                Page 40
  2689.  
  2690.  
  2691.  
  2692.  
  2693.  
  2694.  
  2695.                                     P A R T  I V
  2696.                                     ------------
  2697.  
  2698.  
  2699.  
  2700.  
  2701.  
  2702.  
  2703.                                  Customizing the BBS
  2704.  
  2705.  
  2706.           Introduction:
  2707.  
  2708.                Now that is has  been explained  how to  use the  BBS, it is
  2709.                time to  go into  how you  can customize the BBS to look and
  2710.                act the way you want it to.
  2711.  
  2712.                TransAmiga allows you to do this in a  number of  ways.  You
  2713.                can  change  the  key,  the  access,  and the text for every
  2714.                single command in the  BBS; you  can turn  off commands that
  2715.                you don't want.  You can make your own menus, with different
  2716.                ones for ASCII and ANSI users.   And  you can  customize the
  2717.                BBS text files to give them the look you want.
  2718.  
  2719.  
  2720.  
  2721.  
  2722.  
  2723.  
  2724.  
  2725.  
  2726.  
  2727.  
  2728.  
  2729.  
  2730.  
  2731.  
  2732.  
  2733.  
  2734.  
  2735.  
  2736.  
  2737.  
  2738.  
  2739.  
  2740.  
  2741.  
  2742.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  2743.  
  2744.  
  2745.  
  2746.  
  2747.  
  2748.           TransAmiga BBS User Manual                                Page 41
  2749.  
  2750.  
  2751.                                   Changing Commands
  2752.  
  2753.  
  2754.           The Command Files:
  2755.  
  2756.                Each  command  in  TransAmiga  can  be  customized.  You can
  2757.                assign your own command key,  command  text,  and  a minimum
  2758.                access level  to each  command.  TransAmiga gets information
  2759.                about this from special  command files  for each  menu.  You
  2760.                edit these  command files to customize the menus.  Each menu
  2761.                has its own command file, these all have the suffix ".Cmds".
  2762.                You can edit these with any ordinary text editor.
  2763.  
  2764.                There are  command files for all of TransAmiga's menus.  The
  2765.                files are called:
  2766.  
  2767.                  Main.Cmds         - Main menu commands
  2768.                  File.Cmds         - Files menu commands
  2769.                  Message.Cmds      - Messages menu commands
  2770.                  Bulletin.Cmds     - bulletins menu commands
  2771.                  Settings.Cmds     - Settings menu commands
  2772.                  Extra.Cmds        - Extras menu commands
  2773.  
  2774.                All of them should reside in your configurations directory.
  2775.  
  2776.                Each file follows the same format.  The  first line contains
  2777.                the title  of the  menu.   This is  used in the default menu
  2778.                prompt, and the default menu command listing that users see.
  2779.                Next come  the command  entries, one  for each  on the menu.
  2780.                Each command entry takes up one line and consists of the key
  2781.                used for  the command, the text associated with the command,
  2782.                the access level required for the command to be available to
  2783.                a  user,  and  the  flags  required.  TransAmiga expects the
  2784.                entries to be in a specific order, so do don't  mix commands
  2785.                around.   Leading spaces  are stripped,  and blank lines and
  2786.                lines beginning with a semi-colon (;) are ignored.
  2787.  
  2788.                This is an example of what Main.Cmds might look like:
  2789.  
  2790.                   ; The is an example command file for the Main menu.
  2791.  
  2792.                   ; The first line contains the title of the menu that will
  2793.                   ; appear in the prompt:
  2794.  
  2795.                  Main Menu
  2796.  
  2797.                   ; After that comes the command entries themselves.  First
  2798.                   ; comes the key to be pressed for the command, then the
  2799.                   ; name of the command, followed by the access required.
  2800.  
  2801.  
  2802.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  2803.  
  2804.  
  2805.  
  2806.  
  2807.  
  2808.           TransAmiga BBS User Manual                                Page 42
  2809.  
  2810.  
  2811.                   ; Use the asterisks as a guide to the placement of the
  2812.                   ; fields.
  2813.  
  2814.                  ; ********************** *** ********
  2815.                  T Time                     0 --------
  2816.                  B Bulletins               10 X-------
  2817.                  Y Yell at Tim              0 X-------
  2818.                  C Change Setup            10 X-------
  2819.                  F File Areas              10 X-------
  2820.                  G Good-Bye (Log off)       0 --------
  2821.                  H Help With Commands       0 X-------
  2822.                  J Join TransAmiga          0 --------
  2823.                  M Message Areas           10 X-------
  2824.                  U User List               10 X-------
  2825.                  L Leave Feedback to Tim    0 --------
  2826.                  O Online Programmes       20 X-------
  2827.                  V Version Info             0 --------
  2828.                  W Who's Online?            0 --------
  2829.  
  2830.                   ; THE END
  2831.  
  2832.                There are a few important things to note.  First of all, the
  2833.                length of  each field  is fixed and must not be changed.  If
  2834.                the spacing is altered, the BBS  will probably  fail when it
  2835.                tries to read the file.
  2836.  
  2837.                The number  of entries  in each  command file is fixed, with
  2838.                the exception of the command  file  for  the  bulletins menu
  2839.                (Bulletin.Cmds).  The number of entries in it depends on the
  2840.                number of bulletins you set up.  It has three basic commands
  2841.                then  one  command  for  each  bulletin.    So if you have 7
  2842.                bulletins, your Bulletin.Cmds file will need 10 entries.
  2843.  
  2844.                It is  best to  take the  sample command  files provided and
  2845.                edit  them,  to  be  sure  you get the spacing right and the
  2846.                order of the commands right.   Be sure  to have  a backup of
  2847.                the samples  somewhere, so if you do mess up a command file,
  2848.                you can go back to the original.
  2849.  
  2850.  
  2851.           Disabling Commands:
  2852.  
  2853.                It is not necessary to for all commands  to be  available to
  2854.                users.    Indeed  many  commands  are  intended only for the
  2855.                SysOp.  Some commands you may wish to  disable entirely (for
  2856.                example, if  your board  is for messages only, you will want
  2857.                to  disable  the  command  that  takes   you  to   the  file
  2858.                libraries).   To disable  a command simply give it an access
  2859.  
  2860.  
  2861.  
  2862.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  2863.  
  2864.  
  2865.  
  2866.  
  2867.  
  2868.           TransAmiga BBS User Manual                                Page 43
  2869.  
  2870.  
  2871.                level of 256, and a key that is not being used by any active
  2872.                command.
  2873.  
  2874.  
  2875.  
  2876.  
  2877.  
  2878.  
  2879.  
  2880.  
  2881.  
  2882.  
  2883.  
  2884.  
  2885.  
  2886.  
  2887.  
  2888.  
  2889.  
  2890.  
  2891.  
  2892.  
  2893.  
  2894.  
  2895.  
  2896.  
  2897.  
  2898.  
  2899.  
  2900.  
  2901.  
  2902.  
  2903.  
  2904.  
  2905.  
  2906.  
  2907.  
  2908.  
  2909.  
  2910.  
  2911.  
  2912.  
  2913.  
  2914.  
  2915.  
  2916.  
  2917.  
  2918.  
  2919.  
  2920.  
  2921.  
  2922.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  2923.  
  2924.  
  2925.  
  2926.  
  2927.  
  2928.           TransAmiga BBS User Manual                                Page 44
  2929.  
  2930.  
  2931.                                      Text Files
  2932.  
  2933.  
  2934.           Text Files in TransAmiga:
  2935.  
  2936.                At numerous points during its operation, TransAmiga will use
  2937.                standard ASCII text files to display things.  You create and
  2938.                edit these yourself to give your BBS a customized look.  The
  2939.                following is a list of all  text files  that TransAmiga will
  2940.                display at  one point  in time  or another.  All of them are
  2941.                optional, if TransAmiga can  not find  a text  file, it will
  2942.                simply continue on with the next item of business.
  2943.  
  2944.                Additionally,  whenever  TransAmiga  displays a text file of
  2945.                any kind, if there is  currently  a  user  online  with ANSI
  2946.                graphics   turned   on,   TransAmiga  will  first  look  for
  2947.                <filename>.ANSI (eg. Title.ANSI), and if it can't find that,
  2948.                fallback to  the original  filename.  This allows you create
  2949.                separate files with ANSI graphics for  ANSI users.   You can
  2950.                also  specify  a  language  if  you have changed the current
  2951.                language with  the LOADLANGUAGE  ARexx command,  by adding a
  2952.                period  then  the  language,  eg.  <filename>.<language>  or
  2953.                <filename>.<language>.ANSI.  If you  have  not  changed your
  2954.                language, then  there is  obviously no point is specifying a
  2955.                language.
  2956.  
  2957.                Connected -
  2958.                As soon  as  a  caller  connects,  this  file  is displayed.
  2959.                Generally, this  file should just be a brief welcome message
  2960.                to the user, and not a fancy title  screen.   TransAmiga can
  2961.                detect if  the caller  is using an ANSI terminal, so an ANSI
  2962.                version of this file  can be  displayed, even  though a user
  2963.                isn't logged  on at  the time, and the caller's ANSI setting
  2964.                is unknown.
  2965.  
  2966.                TooSlow -
  2967.                If a caller connects at a baud rate lower than what you have
  2968.                specified as  your minimum  rate, that  caller will be shown
  2969.                this file and then be logged off.
  2970.  
  2971.                Title -
  2972.                This is the main title screen for the BBS, displayed after a
  2973.                user successfully  logs on.   Generally you try to make this
  2974.                an attractive screen telling users a little about your BBS.
  2975.  
  2976.                Guest -
  2977.                When a user logs on who isn't already a member, this file is
  2978.                displayed.   You should  use this  to outline the purpose of
  2979.  
  2980.  
  2981.  
  2982.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  2983.  
  2984.  
  2985.  
  2986.  
  2987.  
  2988.           TransAmiga BBS User Manual                                Page 45
  2989.  
  2990.  
  2991.                your BBS, instructions for  gaining  access,  and  the rules
  2992.                that they must follow.
  2993.  
  2994.                Access.XXX -
  2995.                This displays the file only to users with XXX access.  Using
  2996.                this you can create completely different  displays for users
  2997.                of different  access levels.  The access level must be three
  2998.                digits  long,   padded  with   zeros,  eg.  Access.025.ANSI,
  2999.                Access.010, Access.255.ANSI.
  3000.  
  3001.                News -
  3002.                This is  the last file displayed in the logon process, right
  3003.                before the main menu is displayed.  This is the place to put
  3004.                your news flash type information.
  3005.  
  3006.                Join -
  3007.                This file  is shown when a user selects the command from the
  3008.                main menu to join  the BBS.   Usually  this is  just a brief
  3009.                outline of the requirements for gaining access,
  3010.  
  3011.                Paging -
  3012.                Once a  user selects  the page  command from  the main menu,
  3013.                they will see this  file.   This file  could be  used to say
  3014.                what hours  the SysOp  is likely  to answer the page at, and
  3015.                also to warn off those that abuse the page command.
  3016.  
  3017.                Feedback -
  3018.                When a user issues the Feedback command from  the main menu,
  3019.                this  file  will  be  displayed  immediately before the user
  3020.                starts to enter the message.  A good place to just thank the
  3021.                user for any comments he/she has about the BBS, etc.
  3022.  
  3023.                PreUpload -
  3024.                Users see  this just  before starting  an upload.  This is a
  3025.                good place  to remind  them of  the rules  of uploading, and
  3026.                perhaps a little thank you for their contribution.
  3027.  
  3028.                PreDownload -
  3029.                This is  what users see right before downloading.  This file
  3030.                is a good to remind users not to be file sponges, and if you
  3031.                have an upload:download ratio, to display that.
  3032.  
  3033.                Protocols -
  3034.                If present,  this will replace the menu that is displayed to
  3035.                users when selecting transfer protocols.
  3036.  
  3037.                SendMsg -
  3038.                Whenever a user goes to enter a message  (either through the
  3039.                Write Message  command, through  feedback, or when replying)
  3040.  
  3041.  
  3042.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  3043.  
  3044.  
  3045.  
  3046.  
  3047.  
  3048.           TransAmiga BBS User Manual                                Page 46
  3049.  
  3050.  
  3051.                this text file will first be displayed.  It is good for some
  3052.                quick  instructions  before  writing  a  message  (such as a
  3053.                reminder not to  address  messages  to  "SysOp"  in echomail
  3054.                areas).
  3055.  
  3056.                ReadMode -
  3057.                If  present,  this  will  replace the menu that is displayed
  3058.                when a user goes to select the message reading mode.
  3059.  
  3060.                GoodBye -
  3061.                When a user has confirmed  his/her  desire  to  logoff, this
  3062.                file will  be displayed.   A "Thanks for calling" is usually
  3063.                appropriate here,  and  perhaps  a  brief  listing  of other
  3064.                boards worth calling
  3065.  
  3066.                You can  use just  about any  text editor  (Ed, MEmacs, QEd,
  3067.                etc.) to make these files appear in any  way you  wish.  For
  3068.                ANSI files,  you will  need a  special ANSI  editor, such as
  3069.                Prism or LaDraw.  You are  encouraged to  customize these as
  3070.                much as  you wish.   When  displaying text files, TransAmiga
  3071.                will automatically convert End-of-Line to a  Carriage Return
  3072.                & Linefeed.
  3073.  
  3074.                Most text  displays in TransAmiga can be aborted by pressing
  3075.                the Space Bar or holding Control and pressing C, unless this
  3076.                has been disabled (see later on).
  3077.  
  3078.                Because of  the relative  slowness of  floppy drives, when a
  3079.                text file is being displayed, slight pauses will  be noticed
  3080.                as the  drive steps.  This can be avoided by setting up your
  3081.                text path to be in ram:, and then  in your Startup-Sequence,
  3082.                creating a  text directory  in ram:, then copying all of the
  3083.                BBS's text files into that directory, i.e.
  3084.  
  3085.                  Copy TransAmiga:Text ram:Text all
  3086.  
  3087.  
  3088.           ANSI Graphics:
  3089.  
  3090.                Files ending with .ANSI contain ANSI  graphics escape codes.
  3091.                Anytime TransAmiga  tries to display a text file to a colour
  3092.                with ANSI, it will  automatically add  the .ANSI  suffix and
  3093.                first  look  for  that  file,  and fall back to the original
  3094.                filename if that file is not present.
  3095.  
  3096.                ANSI is a graphics protocol often  used in telecommunication
  3097.                for  changing  colours,  moving  the cursor, etc.  These are
  3098.                displayed only when a user has the ANSI  Graphics option on.
  3099.                The escape  codes make these files rather cumbersome to edit
  3100.  
  3101.  
  3102.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  3103.  
  3104.  
  3105.  
  3106.  
  3107.  
  3108.           TransAmiga BBS User Manual                                Page 47
  3109.  
  3110.  
  3111.                in a text editor, so you  will  probably  want  to  get your
  3112.                hands on  a special  ANSI editor.  One that will get the job
  3113.                done for you is called Prism.  If you have access to  an IBM
  3114.                clone with  at least  CGA graphics  (almost all of them have
  3115.                that), you can use an MS-DOS  ANSI editor,  which in general
  3116.                tend to  be much more powerful than their Amiga counterparts
  3117.                (the Amiga system has little use for ANSI  graphics, they're
  3118.                used almost exclusively in telecommunications).
  3119.  
  3120.                Note that  there are some differences between Amiga ANSI and
  3121.                IBM ANSI.  IBM ANSI is  more  standard,  and  is  capable of
  3122.                displaying  16  colours,  while  Amiga  ANSI (handled by the
  3123.                console.device) only does up to 8  colours, but  can display
  3124.                bold, underline  and italics  text.  TransAmiga uses its own
  3125.                custom ANSI routines which can  handle  both  Amiga  and IBM
  3126.                ANSI codes  (with the  exception of IBM ANSI's flashing text
  3127.                and keyboard remapping).
  3128.  
  3129.                The fonts provided with  TransAmiga have  the upper  set the
  3130.                same as  the IBM  character set  - not like the Amiga's - so
  3131.                the IBM ANSI line drawing characters are available.
  3132.  
  3133.  
  3134.           More?:
  3135.  
  3136.                When a text file is being  displayed,  and  it  is  about to
  3137.                scroll off the top of the screen, TransAmiga will prompt the
  3138.                user with something like "More [32%]?  -Y/N/C-".  TransAmiga
  3139.                is first  telling the  user how much of the text file he/she
  3140.                has viewed so far,  and  then  prompting  him/her  to either
  3141.                continue (Y  or RETURN), to stop viewing the file (N), or to
  3142.                view the file continuously with no more More? prompts (C).
  3143.  
  3144.  
  3145.           Imbedded Control Sequences:
  3146.  
  3147.                TransAmiga allows  more  than  just  straight  text  in text
  3148.                files.   It supports a number of special control codes, that
  3149.                are interpreted by TransAmiga, and tell it to output certain
  3150.                information.    These  control  sequences allow considerable
  3151.                flexibility.  You can use them to cause  a 'Press  RETURN to
  3152.                continue.' prompt  to come  up, to  display the  name of the
  3153.                online, to pause for a few  seconds,  and  a  host  of other
  3154.                things.
  3155.  
  3156.                The control  sequences can  appear anywhere  in a text file,
  3157.                and the file can contain as many of them as you wish.   Here
  3158.                is the complete listing of available control codes:
  3159.  
  3160.  
  3161.  
  3162.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  3163.  
  3164.  
  3165.  
  3166.  
  3167.  
  3168.           TransAmiga BBS User Manual                                Page 48
  3169.  
  3170.  
  3171.                Key            Function                                    
  3172.                CTRL-A         Prompt user to press RETURN
  3173.                CTRL-B         Don't allow users to abort viewing
  3174.                CTRL-C         Enable aborting
  3175.                CTRL-D         Don't bring up More? prompts
  3176.                CTRL-E         Enable More? prompts
  3177.                CTRL-F         Display a piece of user information
  3178.                CTRL-K         Display a piece of system information
  3179.                CTRL-W         Pause for one second
  3180.  
  3181.                CTRL-F  and  CTRL-K  have  special  meanings.  The character
  3182.                following the CTRL-F  or  CTRL-K  determines  what  piece of
  3183.                information TransAmiga displays.
  3184.  
  3185.                CTRL-F   combinations   are   in   general   for  displaying
  3186.                information about the current online caller:
  3187.  
  3188.                Key            Function                                    
  3189.                CTRL-F a       Returns current caller's name
  3190.                CTRL-F b       User's city, province
  3191.                CTRL-F c       User's password (careful)
  3192.                CTRL-F d       User's computer type
  3193.                CTRL-F e       User's telephone number
  3194.                CTRL-F g       User's flags (X is on, - is off)
  3195.                CTRL-F f       Date of user's last call
  3196.                CTRL-F l       User's netmail credit
  3197.                CTRL-F m       Number of messages posted by user
  3198.                CTRL-F n       User's last read in current conference
  3199.                CTRL-F o       User's access level
  3200.                CTRL-F p       Times the user has called the system
  3201.                CTRL-F q       Number of files user has uploaded
  3202.                CTRL-F r       Kilobytes user has uploaded
  3203.                CTRL-F s       Number of files user has downloaded
  3204.                CTRL-F t       Kilobytes user has downloaded
  3205.                CTRL-F u       Total time user has been online today
  3206.                CTRL-F v       User's screen length
  3207.                CTRL-F x       ANSI status (ON or OFF)
  3208.                CTRL-F w       User's first name only
  3209.                CTRL-F 0       User's full-screen editor status (ON or OFF)
  3210.                CTRL-F 1       User's command mode (either Expert or Novice)
  3211.                CTRL-F 2       User's hotkeys status (ON or OFF)
  3212.                CTRL-F 3       User's handle
  3213.                CTRL-F 4       Message read mode (All or Personal)
  3214.                CTRL-F 5       User's birthdate
  3215.                CTRL-F 7       User's upload:download ratio
  3216.                CTRL-F 8       User's street address
  3217.                CTRL-F 9       User's postal code
  3218.  
  3219.  
  3220.  
  3221.  
  3222.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  3223.  
  3224.  
  3225.  
  3226.  
  3227.  
  3228.           TransAmiga BBS User Manual                                Page 49
  3229.  
  3230.  
  3231.                CTRL-K combinations  return  general  information  about the
  3232.                system:
  3233.  
  3234.                Key            Function                                    
  3235.                CTRL-K a       Number of calls system has received
  3236.                CTRL-K b       Last caller to system
  3237.                CTRL-K c       Total number of messages on the system
  3238.                CTRL-K d       Low message in current conference
  3239.                CTRL-K e       High message in current conference
  3240.                CTRL-K h       High user number on system
  3241.                CTRL-K i       Current time
  3242.                CTRL-K j       Current date
  3243.                CTRL-K m       User's time remaining today
  3244.                CTRL-K q       User's daily time limit
  3245.                CTRL-K r       Baud rate of user
  3246.                CTRL-K y       Current message conference
  3247.                CTRL-K z       Current file library
  3248.                CTRL-K 0       Number of messages in current conference
  3249.                CTRL-K 1       Number of current conference
  3250.                CTRL-K 2       Number of current library
  3251.                CTRL-K 3       Current one-liner
  3252.                CTRL-K 4       Who the current one-liner is from
  3253.                CTRL-K 5       Commands available from current menu (command
  3254.                               key of each command, separated by spaces)
  3255.                CTRL-K 6       Path to current message conference
  3256.                CTRL-K 7       Path to current file library
  3257.                CTRL-K 8       Number associated with this BBS line
  3258.                CTRL-K 9       Master configuration file this line is using.
  3259.  
  3260.                The uses for these control codes are almost unlimited.  They
  3261.                are useful in any textfile, including menu and prompt files,
  3262.                and any other text files the BBS displays.
  3263.  
  3264.  
  3265.  
  3266.  
  3267.  
  3268.  
  3269.  
  3270.  
  3271.  
  3272.  
  3273.  
  3274.  
  3275.  
  3276.  
  3277.  
  3278.  
  3279.  
  3280.  
  3281.  
  3282.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  3283.  
  3284.  
  3285.  
  3286.  
  3287.  
  3288.           TransAmiga BBS User Manual                                Page 50
  3289.  
  3290.  
  3291.                              Menus, Prompts & Help Files
  3292.  
  3293.  
  3294.           Menu Files:
  3295.  
  3296.                You actually setup up the BBS's menus when  you created your
  3297.                command files.   When  the user presses ? to see a menu, the
  3298.                BBS constructs  a list  of commands  for which  the user has
  3299.                access  to  on  the  screen.    This  is  quite useful as it
  3300.                displays only the commands the user has sufficient access to
  3301.                use.
  3302.  
  3303.                You may  however wish to design your own menus.  This is all
  3304.                a part of giving your BBS  that  "personal  touch".    To do
  3305.                this, you  will need to create text files for each menu that
  3306.                you want  to be  customized, and  place those  files in your
  3307.                text directory.   TransAmiga allows considerable flexibility
  3308.                when creating you own menus.  You can  create separate menus
  3309.                for specific access levels, or a default menu for all access
  3310.                levels.  As with all  text  files,  you  can  add  the .ANSI
  3311.                suffix  to  create  special  versions  for  ANSI users.  The
  3312.                filenaming conventions for menus are exactly the same as any
  3313.                other text file:
  3314.  
  3315.                  <filename> or
  3316.                  <filename>.ANSI or
  3317.                  <filename>.<language> or
  3318.                  <filename>.<language>.ANSI
  3319.  
  3320.                This  creates  a  default  menu that all users regardless of
  3321.                access will see when they press  '?' at  a menu  prompt.  If
  3322.                you'd like  to have  different menus  displayed depending on
  3323.                the callers  access level,  then you  can create  a menu for
  3324.                specific access levels.  The filenaming convention for doing
  3325.                that is:
  3326.  
  3327.                  <filename>.XXX or
  3328.                  <filename>.XXX.ANSI or
  3329.                  <filename>.XXX.<language> or
  3330.                  <filename>.XXX.<language>.ANSI
  3331.  
  3332.                Where the XXX is a the access level that this menu is  to be
  3333.                displayed to.  The access level must be three digits, padded
  3334.                with zeros.  If a  menu  does  not  exist  for  the caller's
  3335.                access  level,  then  the  default menu is displayed, and if
  3336.                that is  not  available,  then  TransAmiga  builds  the menu
  3337.                display itself,  showing only  those commands  that the user
  3338.                has access to.
  3339.  
  3340.  
  3341.  
  3342.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  3343.  
  3344.  
  3345.  
  3346.  
  3347.  
  3348.           TransAmiga BBS User Manual                                Page 51
  3349.  
  3350.  
  3351.                Now for the actual names of the menu files.  Naturally, each
  3352.                menu within the BBS is going to need its own menu file:
  3353.  
  3354.                  MainMenu     - Main Menu
  3355.                  MsgMenu      - Message Conferences Menu
  3356.                  BlltnMenu    - Bulletins Menu
  3357.                  ExtraMenu    - Extras Menu
  3358.                  FileMenu     - File Libraries Menu
  3359.                  SetMenu      - Settings Menu
  3360.                  MsgConfs     - Menu Listing Available Message Conferences
  3361.                  FileLibs     - Menu Listing Available File Libraries
  3362.  
  3363.                Your  finished  menu  files  go  into  the  text  directory.
  3364.                Example  menu  names  are:  MainMenu.000, FileMenu.255.ANSI,
  3365.                BlltnMenu, ExtraMenu.ANSI, SetMenu.025.ANSI, etc.
  3366.  
  3367.                All the  imbedded control  sequences available in other text
  3368.                files are available in the menu files, as well as the prompt
  3369.                and help files.
  3370.  
  3371.  
  3372.           Prompt Files:
  3373.  
  3374.                Prompt files  are much  like the Menu files described above,
  3375.                except that instead of appearing whenever the user presses ?
  3376.                at a  menu, the  appear right  away (they are menu prompts).
  3377.                Also unlike menu files, you  can  not  have  specific prompt
  3378.                files for  an access  level, users  see the same prompt file
  3379.                regardless of access.   The file  names of  the prompt files
  3380.                are as follows:
  3381.  
  3382.                  MainPrompt        - Main Menu
  3383.                  MsgPrompt         - Message Conferences
  3384.                  FilePrompt        - File Libraries
  3385.                  BlltnPrompt       - Bulletins Menu
  3386.                  ExtrasPrompt      - Extras Menu
  3387.                  ReadPrompt        - Read Messages Sub-menu
  3388.                  ListPrompt        - List Files Sub-menu
  3389.                  ContinuePrompt    - Press Continue Prompt
  3390.  
  3391.                And as  with all  text files  in TransAmiga, you can add the
  3392.                .ANSI suffix to create special versions for users  with ANSI
  3393.                turned on.  If a prompt file isn't available then TransAmiga
  3394.                will display a default menu showing the name of the menu and
  3395.                the amount of online time the user has remaining.
  3396.  
  3397.                All Prompt  files should be in your Text directory.  Example
  3398.                file names are: MainPrompt, MsgPrompt.ANSI, ReadPrompt.ANSI,
  3399.                ReadPrompt, etc.
  3400.  
  3401.  
  3402.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  3403.  
  3404.  
  3405.  
  3406.  
  3407.  
  3408.           TransAmiga BBS User Manual                                Page 52
  3409.  
  3410.  
  3411.  
  3412.                The  CTRL-K  5  imbedded  control  sequence  is particularly
  3413.                useful in the prompt  files, as  it gives  the user  a quick
  3414.                listing of what commands he/she has available.
  3415.  
  3416.  
  3417.           Help Files:
  3418.  
  3419.                TransAmiga has provisions for providing online help to users
  3420.                of your BBS.    Each  menu  has  a  Help  command,  and when
  3421.                selected by a user, TransAmiga will display a help text file
  3422.                for that menu.  These files all end  in Help  and all reside
  3423.                in your  text directory.   The  filenames for the help files
  3424.                are:
  3425.  
  3426.                  MainHelp
  3427.                  MsgHelp
  3428.                  FileHelp
  3429.                  ExtraHelp
  3430.                  BlltnHelp
  3431.                  SetHelp
  3432.                  SysOpHelp (actually used by TrMaint, not TransAmiga)
  3433.                  TransEdHelp
  3434.  
  3435.                As you can see there is a help file for each menu.  Although
  3436.                you don't  actually have  to have  these files around, it is
  3437.                highly recommended that  you  make  them.    For  novice BBS
  3438.                users,  getting  around  can  be  a little difficult, so you
  3439.                should try  to help  them out  with information  in the help
  3440.                files.
  3441.  
  3442.                And as  with all  text files  in TransAmiga, you can add the
  3443.                .ANSI suffix to create special versions for users  with ANSI
  3444.                turned on.  If a prompt file isn't available then TransAmiga
  3445.                will display a default menu showing the name of the menu and
  3446.                the amount of online time the user has remaining.
  3447.  
  3448.  
  3449.           Language Files:
  3450.  
  3451.                Almost all  of the  text strings displayed by TransAmiga can
  3452.                be found in files in the  Configs directory  called language
  3453.                files.   Language files  can be identified by the .Lang file
  3454.                extension.  Language files  are  actually  just  simple text
  3455.                files containing  the various  prompts and messages that the
  3456.                user will see.  Things such as the  'Enter your  full name:'
  3457.                and 'Privileged message?' prompts are in this file.
  3458.  
  3459.  
  3460.  
  3461.  
  3462.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  3463.  
  3464.  
  3465.  
  3466.  
  3467.  
  3468.           TransAmiga BBS User Manual                                Page 53
  3469.  
  3470.  
  3471.                When  the  BBS  starts  up,  it loads a language file called
  3472.                Default.Lang.  By editing the default language file, you can
  3473.                change the  text that the user sees.  If you have ARexx, you
  3474.                can use the LOADLANGUAGE  ARexx  command  to  switch between
  3475.                different language files.
  3476.  
  3477.                Each line  of a language file contains one text string.  The
  3478.                only way you can tell which prompt appears  when in  the BBS
  3479.                is from  the text  itself and from experience with using the
  3480.                BBS.  When editing it, you must be extremely careful  not to
  3481.                remove lines,  or to  shuffle lines around.  You should also
  3482.                refrain from putting any control sequences, such as ANSI, in
  3483.                these prompts.   And  most importantly,  be sure  you have a
  3484.                copy of the original Default.Lang file  backed up somewhere,
  3485.                so that you can revert to that should something go wrong.
  3486.  
  3487.                Editting language  files is  for advanced users only, do not
  3488.                alter language files unless you know what you are doing.  
  3489.  
  3490.  
  3491.  
  3492.  
  3493.  
  3494.  
  3495.  
  3496.  
  3497.  
  3498.  
  3499.  
  3500.  
  3501.  
  3502.  
  3503.  
  3504.  
  3505.  
  3506.  
  3507.  
  3508.  
  3509.  
  3510.  
  3511.  
  3512.  
  3513.  
  3514.  
  3515.  
  3516.  
  3517.  
  3518.  
  3519.  
  3520.  
  3521.  
  3522.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  3523.  
  3524.  
  3525.  
  3526.  
  3527.  
  3528.           TransAmiga BBS User Manual                                Page 54
  3529.  
  3530.  
  3531.  
  3532.  
  3533.  
  3534.                                      P A R T  V
  3535.                                      ----------
  3536.  
  3537.  
  3538.  
  3539.  
  3540.  
  3541.  
  3542.                                   FidoNet Explained
  3543.  
  3544.  
  3545.  
  3546.           Introduction:
  3547.  
  3548.                The purpose of this section document is to give you  all you
  3549.                need to set up TransAmiga as a fully operational node within
  3550.                FidoNet.  Because of the tremendous  depth of  FidoNet, what
  3551.                is described here really only scratches the surface.  As you
  3552.                become  more  experienced  with  FidoNet,  you  will  become
  3553.                knowledgeable enough to do things on your own.
  3554.  
  3555.  
  3556.           The Basics of FidoNet:
  3557.  
  3558.                FidoNet  (and  other  similar  mail  networks) is a group of
  3559.                bulletin board systems that can exchange  messages and files
  3560.                through  automated  computer  operations.   With over 10,000
  3561.                member "nodes" worldwide,  FidoNet  is  the  largest amateur
  3562.                mail network  in the  world.   A "phonebook" or directory of
  3563.                all member systems,  called  the  nodelist  file,  lists all
  3564.                currently active FidoNet systems.
  3565.  
  3566.                But what  does FidoNet do?  At the most basic level, FidoNet
  3567.                simply offers an organized protocol for  systems to exchange
  3568.                files.   Where the  power lies  is in  the contents of those
  3569.                files.
  3570.  
  3571.                FidoNet has several major features.  The first is netmail or
  3572.                matrix  mail.    Netmail  allows  you  to  send a privileged
  3573.                message to anyone in the world (that has access to a FidoNet
  3574.                system)  for  a  small  cost  -  usually less than that of a
  3575.                stamp.  All you need to know is their name and their FidoNet
  3576.                address.
  3577.  
  3578.                The most  commonly used feature is echomail.  Echomail areas
  3579.                are large public message  conferences where  groups of users
  3580.  
  3581.  
  3582.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  3583.  
  3584.  
  3585.  
  3586.  
  3587.  
  3588.           TransAmiga BBS User Manual                                Page 55
  3589.  
  3590.  
  3591.                can discuss  almost anything  (in the appropriate topic area
  3592.                of  course).    There  are  hundreds   of  different  echoes
  3593.                available that cover just about every topic from Amiga music
  3594.                to back pain.  Echomail  differs  from  netmail  in  that it
  3595.                involves  open   conferences  where   multiple  people  will
  3596.                simultaneously be involved in  several conversations.   It's
  3597.                roughly equivalent  to local  message areas on most bulletin
  3598.                boards.
  3599.  
  3600.  
  3601.           Topography:
  3602.  
  3603.                FidoNet's method of organization is based  on various levels
  3604.                of  sub-divisions  based  mainly  on  geography.    Here's a
  3605.                general overview of the hierarchy:
  3606.  
  3607.                                         Zones
  3608.                                           |
  3609.                                        Regions
  3610.                                           |
  3611.                                          Nets
  3612.                                           |
  3613.                                         Nodes
  3614.                                           |
  3615.                                         Points
  3616.  
  3617.                Where Zones  at the  top represent  the largest geographical
  3618.                area, down  to Nodes  and Points  which represent individual
  3619.                users.  Each individual zone, region, etc., is identified by
  3620.                a number.
  3621.  
  3622.                There  are  five  zones,  each  zone represents a continent.
  3623.                Zone 1 is North America, 2  is Europe,  and 3  is Australia.
  3624.                Within  each  zone,  there  are  regions.  Regions are still
  3625.                reasonably large areas, most  zones contain  in the  area of
  3626.                10.   For example, region 12 in zone 1 comprises most of the
  3627.                provinces of Quebec and Ontario.
  3628.  
  3629.                The next level down FidoNet is the net. A net usually covers
  3630.                an area code, or a large city, and they usually contain from
  3631.                15 to 200 nodes.  A  node  consists  of  one  single system.
  3632.                Most  node   operators  also  run  BBS's.    These  are  the
  3633.                individuals that  actually make  up FidoNet.   The numbering
  3634.                system for  nets and  nodes is a little different than zones
  3635.                and regions, in that  net  numbers  can  be  repeated across
  3636.                different  zones,  and  node  numbers can be repeated across
  3637.                different nets.  For example, there exists a net 247 in both
  3638.                zone 1  and zone 2, and several nets contain the node number
  3639.  
  3640.  
  3641.  
  3642.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  3643.  
  3644.  
  3645.  
  3646.  
  3647.  
  3648.           TransAmiga BBS User Manual                                Page 56
  3649.  
  3650.  
  3651.                192.  The simple fact that  they are  in different  zones or
  3652.                nets is enough to distinguish between the two.
  3653.  
  3654.                There  is  one  last  level  below the node, and that is the
  3655.                point.  A point is also an individual user, but  is actually
  3656.                a sort  of "child" of a node, and is dependant on that node,
  3657.                its so-called bossnode.   Usually points  are run  by people
  3658.                who like to simply read messages in the comfort of their own
  3659.                home,  but  do  not  want  the  greater  responsibilities of
  3660.                operating a  node, although  some points do run BBS's.  Also
  3661.                of note is that points do not get listed in the nodelist.
  3662.  
  3663.                This  simply   diagram  illustrates   the  hierarchy  within
  3664.                FidoNet:
  3665.  
  3666.                                         Zone 1
  3667.                                           |
  3668.                                    +------+------+
  3669.                                    |             |
  3670.                                Region 12     Region 13
  3671.                                    |
  3672.                               +----+----+
  3673.                               |         |
  3674.                            Net 163   Net 247
  3675.                                         |
  3676.                                    +----+----+
  3677.                                    |         |
  3678.                             1:247/205.0   1:247/192.0
  3679.                                              |
  3680.                                         +----+----+
  3681.                                         |         |
  3682.                                  1:247/192.2   1:247/192.5
  3683.  
  3684.  
  3685.           Your Address:
  3686.  
  3687.                Who  and  where  you  are  in  FidoNet is identified by your
  3688.                FidoNet address.  Your address follows the format:
  3689.  
  3690.                  zone:net/node.point
  3691.  
  3692.                Note that your region is not identified in your address.  As
  3693.                an example,  point 5 running off node 117 in net 247 in zone
  3694.                1 would have an address of 1:247/117.5.  If you  are a node,
  3695.                you don't have a point number, and it is either written as 0
  3696.                or left off completely.  If the zone is left out, it is also
  3697.                usually safe to assume that the zone is the same as yours.
  3698.  
  3699.  
  3700.  
  3701.  
  3702.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  3703.  
  3704.  
  3705.  
  3706.  
  3707.  
  3708.           TransAmiga BBS User Manual                                Page 57
  3709.  
  3710.  
  3711.                Often you  will here talk of 2-Dimensional addressing and 4-
  3712.                Dimensional  addressing.    A  2-D  address  means  just the
  3713.                net/node numbers  of FidoNet  systems.  4-D addressing means
  3714.                the ability to deal with full zone:net/node.point addresses.
  3715.                In the  old days,  most programmes  were only capable of 2-D
  3716.                addressing, so things got confusing when you the  need arose
  3717.                to communicate  with points  and out-of-zone  systems.  Most
  3718.                new FidoNet programmes are capable of full 4-D addressing.
  3719.            
  3720.                Here are some more examples of FidoNet address:
  3721.  
  3722.                  1:247/202
  3723.                  1:163/109.1
  3724.                  2:247/4
  3725.                  3:113/202.0
  3726.  
  3727.  
  3728.           The Nodelist:
  3729.  
  3730.                As has been mentioned,  the nodelist  is basically FidoNet's
  3731.                telephone  directory.    It  lists  all  member  nodes,  who
  3732.                operates them,  the city  they are  based in,  and the phone
  3733.                number  of  the  system.    The nodelist file itself is very
  3734.                large, about one megabyte uncompressed.
  3735.  
  3736.                Because of the size of the nodelist, it becomes difficult to
  3737.                make any changes in it.  Every week, several hundred changes
  3738.                have to be made as new nodes come up, and old nodes go down.
  3739.                Instead of  getting a  completely new nodelist file, special
  3740.                file  are  distributed   containing   the   changes,  called
  3741.                NodeDiff's.
  3742.  
  3743.                To  actually  make  the  changes to the nodelist, a nodelist
  3744.                processor is required.  This not only processes the NodeDiff
  3745.                files,  but  also  optimizes  the nodelist for fast and easy
  3746.                access.
  3747.  
  3748.  
  3749.           Joining FidoNet:
  3750.  
  3751.                Before  moving  onto  the  mechanics  of   interfacing  with
  3752.                FidoNet,  we  should  perhaps  mention  how to join FidoNet.
  3753.                What you  need to  get is  a node  number.   It doesn't cost
  3754.                anything to join FidoNet as a SysOp.  Some nets have special
  3755.                files about becoming a member of their net, and most FidoNet
  3756.                SysOps will  be glad  to help  you apply  for a node number.
  3757.                Usually, you are required  to send  a netmail  message (from
  3758.                your system) to the net co-ordinator of the network you wish
  3759.                to join to demonstrate that  you  support  at  least minimal
  3760.  
  3761.  
  3762.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  3763.  
  3764.  
  3765.  
  3766.  
  3767.  
  3768.           TransAmiga BBS User Manual                                Page 58
  3769.  
  3770.  
  3771.                FidoNet functions.   The Net Co-ordinator's node number will
  3772.                always be zone:net/0.  When you  send the  message, set your
  3773.                node number  as zone:net/9999.   Include all the information
  3774.                you feel he/she will require, including  your address, voice
  3775.                phone number,  etc.  After two weeks or so you should have a
  3776.                node number.
  3777.  
  3778.                Traditionally, FidoNet has  been  available  only  to MS-DOS
  3779.                users, and Amiga FidoNet software has only been developed in
  3780.                the last  couple  of  years.    Unfortunately,  most FidoNet
  3781.                software is  either expensive  or only suitable for a single
  3782.                user point setup.  TransAmiga bridges the gap  between price
  3783.                and  performance  for  Amiga  FidoNet, by bringing you a low
  3784.                cost BBS that works fully in a FidoNet setup.
  3785.  
  3786.  
  3787.  
  3788.  
  3789.  
  3790.  
  3791.  
  3792.  
  3793.  
  3794.  
  3795.  
  3796.  
  3797.  
  3798.  
  3799.  
  3800.  
  3801.  
  3802.  
  3803.  
  3804.  
  3805.  
  3806.  
  3807.  
  3808.  
  3809.  
  3810.  
  3811.  
  3812.  
  3813.  
  3814.  
  3815.  
  3816.  
  3817.  
  3818.  
  3819.  
  3820.  
  3821.  
  3822.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  3823.  
  3824.  
  3825.  
  3826.  
  3827.  
  3828.           TransAmiga BBS User Manual                                Page 59
  3829.  
  3830.  
  3831.                                FidoNet and TransAmiga
  3832.  
  3833.  
  3834.           Introduction:
  3835.  
  3836.                TransAmiga supports FidoNet as  a  point  or  a  node.   The
  3837.                difference between  a node  and a  point is basically that a
  3838.                node is more independent.  Not  much time  will be  spent on
  3839.                using  TransAmiga  as  a  point,  as it is not all that much
  3840.                difference, and the advantages of being a node are such that
  3841.                it is recommended that you become one.
  3842.  
  3843.                To actually  have a  complete running  FidoNet setup, you'll
  3844.                need more than just TransAmiga, as it is  only one component
  3845.                in  a  total  FidoNet  setup.    Unlike  other  BBS software
  3846.                packages, TransAmiga  does  not  attempt  to  "re-invent the
  3847.                wheel" by  attempting to write equivalents of perfectly good
  3848.                FidoNet tools that already  exist.   History has  shown that
  3849.                this  leads   to  many  compromises  in  both  features  and
  3850.                performance.
  3851.  
  3852.                So in addition  to  the  BBS,  a  basic  FidoNet  setup with
  3853.                TransAmiga involves the following software:
  3854.  
  3855.                  1. The mailer (sometimes called a session handler or a
  3856.                     frontend)
  3857.                  2. The mail processor (also called a mail packer, or
  3858.                     mail tosser)
  3859.                  3. The message reader and editor.
  3860.  
  3861.                (Most complete  setups will  include more  software.  If you
  3862.                are feeding echomail conferences  to points  or other nodes,
  3863.                an  AreaFix  utility  is  needed.   If you are handling file
  3864.                echoes, a Tick utility is needed.  These kinds of setups are
  3865.                much more  involved, and  tend to be highly personalized, so
  3866.                it is beyond the scope of  this document.   We  will just go
  3867.                into a basic setup.)
  3868.  
  3869.                The purpose  of the message reader/editor is fairly obvious,
  3870.                but the mailer and mail processor require some explanation.
  3871.  
  3872.                As we said, FidoNet  basically involves  the transferring of
  3873.                files from  system to  system over  the modem.  This is what
  3874.                the mailer does.  It makes calls and receives calls  for the
  3875.                sending and  receiving of  files.  The files can be anything
  3876.                but are usually packed messages.  When your  mailer connects
  3877.                with another  mail system (either by you calling out, or the
  3878.                other  system  calling  you),  a  handshaking   protocol  is
  3879.                performed, which  basically involved  telling each other who
  3880.  
  3881.  
  3882.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  3883.  
  3884.  
  3885.  
  3886.  
  3887.  
  3888.           TransAmiga BBS User Manual                                Page 60
  3889.  
  3890.  
  3891.                you are.  Then, one at a time, each end sends any files that
  3892.                are destined  for the  other.  After each end has done this,
  3893.                the call has completed and they disconnect.
  3894.  
  3895.                Now the mail processor enters the scene.   Every message you
  3896.                enter on  your system in either an echomail conference or in
  3897.                netmail needs to be processed  and  packed  into  a "bundle"
  3898.                ready  to   be  sent   or  picked   up  by  another  system.
  3899.                Conversely, you will receive all your mail in these bundles,
  3900.                which  will   need  to  be  unpacked  and  placed  into  the
  3901.                appropriate areas.  This is what the mail processor is for.
  3902.  
  3903.                There are two major mailers for the Amiga, Welmat by Russell
  3904.                McOrmand and  Michael Richardson, and TrapDoor by Maximilian
  3905.                Hantsch and Martin  Laubach.    Both  programmes  have their
  3906.                strengths and  weaknesses, and  both are  equally suited for
  3907.                use with TransAmiga, so you may  use which  ever you prefer.
  3908.                Be warned that you will need to register TrapDoor before you
  3909.                can use it properly in a node environment.  Be sure that the
  3910.                version of Welmat you have is at least 0.44, and TrapDoor is
  3911.                at least 1.80.
  3912.  
  3913.                As far as mail processors go, you have  a few  more choices.
  3914.                There  are  several  major ones, including: GCCHost, Foozle,
  3915.                TrapToss, and Conference Mail  ("ConfMail" or  just "CM" for
  3916.                short).
  3917.  
  3918.  
  3919.           Setting up FidoNet:
  3920.  
  3921.                The  first   step  is   to  obtain   the  other  programmes.
  3922.                TransAmiga's support board, Chris'  Amiga BBS  HST (716)289-
  3923.                3351 has  most of the above mentioned programmes if there is
  3924.                no where closer to you that has them.
  3925.  
  3926.                You will also need to obtain a copy  of the  nodelist.  This
  3927.                is a  rather big  file (about  400k compressed,  almost 1 MB
  3928.                uncompressed), but is essential  in a  FidoNet setup.   This
  3929.                should  be  available  from  most FidoNet BBS's.  TransAmiga
  3930.                uses a programme called TrNode to access the  nodelist.  Two
  3931.                versions of  TrNode are  provided, once called TrNode.tl and
  3932.                the other is called TrNode.nl.  The former  is for  use with
  3933.                traplist.library  (which  you  will  be  using  if  you  use
  3934.                TrapDoor as  your  mailer),  while  the  latter  is  used by
  3935.                nodelist.library (which  you will be using if Welmat is your
  3936.                mailer).  Rename the appropriate version to just TrNode, and
  3937.                place it somewhere in the default search path.
  3938.  
  3939.  
  3940.  
  3941.  
  3942.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  3943.  
  3944.  
  3945.  
  3946.  
  3947.  
  3948.           TransAmiga BBS User Manual                                Page 61
  3949.  
  3950.  
  3951.                Once you  have obtained  the necessary  programmes, read the
  3952.                documentation thoroughly and  attempt  to  setup  the config
  3953.                files.   You may  wish to refer to the sample configurations
  3954.                provided in Appendix I.  These examples assume that all your
  3955.                FidoNet message  areas are  in the logical device Mail:.  If
  3956.                not, it is suggested that you assign Mail: to point  to this
  3957.                area,  otherwise  you  will  have  to  adjust  the  examples
  3958.                slightly.
  3959.  
  3960.                Within Mail:,  you'll need  to create  some directories that
  3961.                several of the FidoNet utilities will use.  The first should
  3962.                be called  'Outbound',  this  is  where  programmes  such as
  3963.                ConfMail will  place all  files that  are to  be sent out to
  3964.                other systems.  The second is  called 'Inbound',  and as you
  3965.                might have  guessed, this  is where  all files received from
  3966.                other systems go.  You will also need to create  a directory
  3967.                called  'Nodelist',  which  is  where all the nodelist files
  3968.                will go.
  3969.  
  3970.                Some preparations within TransAmiga will also  be necessary.
  3971.                To  do  this  you  must  run  TransCfg and edit your message
  3972.                configuration.    You  must  fill  in  the  questions  about
  3973.                FidoNet.
  3974.  
  3975.                One  of  the  first  things  you  do  is set up your FidoNet
  3976.                addresses.  In TransAmiga  you  may  have  several addresses
  3977.                (for example,  if you belong to more than one network, or if
  3978.                you hold a position such as  Net Co-ordinator),  though most
  3979.                people  will  only  have  one address.  Network addresses in
  3980.                TransAmiga  are  5-dimension,  consisting  not  only  of the
  3981.                normal zone,  net, node  and point,  but also of an optional
  3982.                domain, which indicates the  name of  the network.   Usually
  3983.                this is not needed unless you are several networks.  You can
  3984.                also set a pointnet (also known as fakenet) to go  with each
  3985.                address.   Use this only if you are a point with a pointnet,
  3986.                nodes that have points should not  use this.   Also,  if you
  3987.                are a  point and your bossnode is running software that does
  3988.                not require a pointnet,  you may  enter a  pointnet of zero,
  3989.                and  TransAmiga  will  create the proper 3-dimensional PATH:
  3990.                kludge lines.
  3991.  
  3992.                The rest should be straightforward enough,  you simply enter
  3993.                your  address,  then  your  inbound,  outbound, and nodelist
  3994.                directories.  Then all you have to do  is setup  the FidoNet
  3995.                areas.   This is  just like adding any other kind of message
  3996.                area,  except  you  will  need  to  say  which  one  of your
  3997.                addresses to  use (normally  just number  1 if you have only
  3998.                setup one address), and give  an  origin  line  for echomail
  3999.                areas.   When doing so, do not enter the '* Origin:' string,
  4000.  
  4001.  
  4002.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  4003.  
  4004.  
  4005.  
  4006.  
  4007.  
  4008.           TransAmiga BBS User Manual                                Page 62
  4009.  
  4010.  
  4011.                or  your  address  at  the  end,  as  this   will  be  added
  4012.                automatically.
  4013.  
  4014.                Your mail directory tree may now look something like this:
  4015.  
  4016.                                          Mail:
  4017.                                            |
  4018.               +-------+-------+--------+---+--+------+------+--------+
  4019.               |       |       |        |      |      |      |        |
  4020.           Personal General Computers Matrix Echo Inbound NodeList Outbound
  4021.                                               |
  4022.                                +---------+----+----+--------+
  4023.                                |         |         |        |
  4024.                            Amiga_Prog  Amiga  TransAmiga Amy_Point
  4025.  
  4026.  
  4027.           Events:
  4028.  
  4029.                The  command  used  to  start  up the BBS requires some more
  4030.                indepth explanation.  In TrapDoor,  this  is  set  using the
  4031.                BBSCOMMAND, and in Welmat using BBSExecute.
  4032.  
  4033.                At first,  you may  think that all that has to be done is to
  4034.                simply start  the BBS  in immediate  logon mode  at the baud
  4035.                rate of  the call that Welmat or TrapDoor answers.  But this
  4036.                is too rigid for our purposes,  and does  not accomplish all
  4037.                we need to.
  4038.  
  4039.                To run  a fully-operational  node, certain other things have
  4040.                to happen, called "events".  For  example, at  some point in
  4041.                time you will have to call out to receive your mail bundles.
  4042.                Then you'll need to  unpack those  bundles, and  you'll also
  4043.                have to create bundles of your own to send out.
  4044.  
  4045.                We  will  divide  up  the  events  into two categories: time
  4046.                driven events, and BBS  driven events.   Time  driven events
  4047.                are things  we want  to happen at a certain time in the day.
  4048.                For instance, you usually want to have your  system call out
  4049.                for mail  during the  night sometime.  BBS driven events are
  4050.                things that need to be done due to  something a  user on the
  4051.                BBS has  done, for  example entering a netmail message, will
  4052.                would need to be packed up and sent off.
  4053.  
  4054.                Lets get  a  basic  listing  of  actions  that  initiate the
  4055.                events, and  how we  want things  to react when these events
  4056.                happen:
  4057.  
  4058.                Action:                     Reaction:
  4059.                - User enters a FidoNet     - Tell mail processor to
  4060.  
  4061.  
  4062.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  4063.  
  4064.  
  4065.  
  4066.  
  4067.  
  4068.           TransAmiga BBS User Manual                                Page 63
  4069.  
  4070.  
  4071.                  message                     export
  4072.                - Mail is delivered         - Tell mail processor to import
  4073.                - Zone Mail Hour            - Tell mailer not  to  allow BBS
  4074.                                              callers or file requests
  4075.                - Time to poll for mail     - Tell mail  processor to export
  4076.                                              any remaining  messages.  Tell
  4077.                                              the  mailer  to call all nodes
  4078.                                              with  waiting  mail,  and also
  4079.                                              the   feed   for   our   mail.
  4080.                                              Import   any   received   mail
  4081.                                              bundles.     Renumber  message
  4082.                                              areas.
  4083.  
  4084.                This is just the basic set  of events,  once you  get things
  4085.                running you will probably want more.
  4086.  
  4087.  
  4088.           Exporting Mail:
  4089.  
  4090.                The  most  simple  event  is  exporting mail when a user has
  4091.                entered a FidoNet message.  To do this,  we must  change the
  4092.                way the  BBS gets  started up.  Instead of having the mailer
  4093.                run the BBS, the mailer should  execute an  AmigaDOS script,
  4094.                which would  check the  return value  from the BBS to see if
  4095.                any netmail or echomail was  entered  (or  both)  and  do an
  4096.                export.   Keep in  mind that  the user  will not actually be
  4097.                hung-up until control returns  to the  mailer, so  any after
  4098.                BBS  operations  must  be executed asynchronously (eg. using
  4099.                the DOS Run command).
  4100.  
  4101.  
  4102.           Importing Mail:
  4103.  
  4104.                Exporting would normally be handled by  your control script,
  4105.                however if  you are  using TrapDoor,  it has  the ability to
  4106.                execute a command after every mail  session, so  it would be
  4107.                easiest to  have your  importing done there.  Just have your
  4108.                AFTERSESSION command execute a  script  that  call  the mail
  4109.                processor to import mail.
  4110.  
  4111.  
  4112.           Time Driven Events:
  4113.  
  4114.                Now we  must handle the other kind of event, one caused by a
  4115.                certain time of the day.  To do this, we  must first  have a
  4116.                means of  finding out  when that  time of day is.  A type of
  4117.                programme called a "Cron"  executes commands  a certain time
  4118.                of day,  which may be easiest for you.  There are several of
  4119.  
  4120.  
  4121.  
  4122.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  4123.  
  4124.  
  4125.  
  4126.  
  4127.  
  4128.           TransAmiga BBS User Manual                                Page 64
  4129.  
  4130.  
  4131.                these utilities available.  Two of the more popular ones are
  4132.                DCron and TPTCron.
  4133.  
  4134.                All  you  have  to  do  is  set these to start up scripts to
  4135.                handle your various events at the correct time of day.
  4136.  
  4137.  
  4138.           Advanced Usage:
  4139.  
  4140.                There is an alternate way to have the mailer start  the BBS,
  4141.                which  is  slightly  more  involved.    It  involves keeping
  4142.                TransAmiga running in memory at all  times, waiting  on it's
  4143.                ARexx port  (using the  -r command  line option).   When the
  4144.                mailer receives a human caller, it would send ARexx messages
  4145.                to TransAmiga telling it to log the caller on (see the ARexx
  4146.                command reference section).
  4147.  
  4148.                The advantage of doing things this  way is  that it provides
  4149.                nearly  instantaneous  transitions  from  mailer to BBS, and
  4150.                avoids the short loading time delay  of the  running the BBS
  4151.                for every  caller.   The disadvantages  are that it consumes
  4152.                more memory as the  mailer and  the BBS  will be  running in
  4153.                memory, and it is more complicated to setup.
  4154.  
  4155.  
  4156.           Other Mailers:
  4157.  
  4158.                TrapDoor and  Welmat or the only mailers currently available
  4159.                that  are  capable  of  supporting  a  BBS  in  a  full-node
  4160.                environment.    This  may  change however, and hopefully the
  4161.                design of TransAmiga is such that getting any new mailers to
  4162.                work with it won't cause a problem.
  4163.  
  4164.  
  4165.           TrUMP:
  4166.  
  4167.                TrUMP  is  a  special  utility for TransAmiga, it stands for
  4168.                TransAmiga Update Message Pointers.  What it does is to save
  4169.                the  high  and  low  message  numbers  in  a FidoNet message
  4170.                directory, so that TransAmiga does  not  have  to  perform a
  4171.                time  consuming  message  base  scan  when users are online.
  4172.                TrUMP is intended only for FidoNet areas, as they will often
  4173.                be accessed by programmes other than the BBS, but it is also
  4174.                safe to use on local areas should they need to  be rescanned
  4175.                for some reason.
  4176.  
  4177.                TrUMP  needs  to  be  run  any time that the low and/or high
  4178.                message number in an area changes.    It  must  also  be run
  4179.                after the  initial setup  of any  matrix or echo conference.
  4180.  
  4181.  
  4182.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  4183.  
  4184.  
  4185.  
  4186.  
  4187.  
  4188.           TransAmiga BBS User Manual                                Page 65
  4189.  
  4190.  
  4191.                Run TrUMP right after: importing, renumbering, deleting, and
  4192.                after messages  have been added by some programme other than
  4193.                TransAmiga.
  4194.  
  4195.                If you do not run TrUMP  on affected  areas, TransAmiga will
  4196.                have incorrect  values for the high and low message numbers,
  4197.                which could cause messages to be overwritten.
  4198.  
  4199.                TrUMP must be run from the CLI or shell as follows:
  4200.  
  4201.                  TrUMP <mail dir 1> [<mailer dir n>...]
  4202.  
  4203.                All you do is give TrUMP a listing of the  directories to be
  4204.                rescanned.    Foozle  users  should  note  that  there is an
  4205.                alternate usage  form  for  TrUMP,  see  later  on  for more
  4206.                details.
  4207.  
  4208.                If  you  run  TrUMP  while TransAmiga is running, TransAmiga
  4209.                will  not  immediately  become  aware  of  the  new  message
  4210.                pointers (unless you use the RESCAN ARexx command, described
  4211.                later), however, TransAmiga will re-read the message pointer
  4212.                file before it adds any messages.  Therefore it is perfectly
  4213.                safe to run TrUMP while TransAmiga  is running  (but see the
  4214.                important section below on TrAL).
  4215.  
  4216.           TrAL:
  4217.  
  4218.                As you  become more  advanced with your system, you may find
  4219.                times when  it would  be convenient  to make  changes to the
  4220.                message bases  while the BBS is still running, and possibly,
  4221.                users are online.  Usually,  these  sorts  of  practices are
  4222.                totally  out-of-the-question  because  of the threat of your
  4223.                programme trying to access a file at the exact same  time as
  4224.                the  BBS  does.    For  example, when running FidoNet, it is
  4225.                usually necessary to disallow  humans from  logging onto the
  4226.                BBS while the mail processor was running.
  4227.  
  4228.                TransAmiga offers  a solution to this problem in TrAL, which
  4229.                allows  you  to  temporarily  tell  TransAmiga  to  lock out
  4230.                writing to  the message  bases so  that other programmes can
  4231.                access them safely even if there are users online.
  4232.  
  4233.                With the message areas  locked,  other  programmes  can then
  4234.                work  with  the  message  areas, doing things like importing
  4235.                messages, etc.  It is not, however, safe to run  any process
  4236.                that modifies  existing messages  when the message areas are
  4237.                locked, only things that add new messages.
  4238.  
  4239.  
  4240.  
  4241.  
  4242.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  4243.  
  4244.  
  4245.  
  4246.  
  4247.  
  4248.           TransAmiga BBS User Manual                                Page 66
  4249.  
  4250.  
  4251.                To use TrAL, you start it  from the  shell in  the following
  4252.                manner:
  4253.  
  4254.                  TrAL [L|U]
  4255.  
  4256.                Tral L  tells TransAmiga that users are Locked from writing,
  4257.                and TrAL U Unlocks them.  Be sure to match every TrAL L with
  4258.                a TrAL U, or users won't be able to write messages.
  4259.  
  4260.                Typically, scripts that call the mail processor should first
  4261.                do  a  TrAL  L,  go  about  their  business,  run  TrUMP  if
  4262.                necessary, then run TrAL U.
  4263.  
  4264.  
  4265.           Renumbering:
  4266.  
  4267.                Sooner or  later, FidoNet  areas will have to be renumbered.
  4268.                Many people like to do this on a regular basis,  others wish
  4269.                to do this only once in a while.
  4270.  
  4271.                In order  for individual users' last read pointers to remain
  4272.                accurate after a renumber, the tool you use  for renumbering
  4273.                must  update   TransAmiga  last  read  pointers,  which  are
  4274.                contained  in  files  called  LastRead.BBS  in  each message
  4275.                directory.   At the time of writing, ConfMail v1.12 supports
  4276.                this (older versions of  ConfMail did  not), and  support is
  4277.                planned  for  GCCHost.    If  you  are  using  another  mail
  4278.                processor, check the documentation to see whether or  not it
  4279.                supports updating of TransAmiga's last read pointers.  If it
  4280.                doesn't, tell the author  he/she should  fix that.   For the
  4281.                time being  you'll have  to either  use another programme to
  4282.                handle renumbering, or simply don't renumber at all.
  4283.  
  4284.                Although Foozle does  not  directly  update  TransAmiga last
  4285.                read pointers, TrUMP may be used in a special manner so that
  4286.                last read pointers are  properly updated.   To  do this, you
  4287.                must  use   Foozle's  FzI  utility  to  edit  your  External
  4288.                commands.  Set the after-renumber command to something like:
  4289.  
  4290.                  BBS:Bin/TrUMP %r %d
  4291.  
  4292.                What you need to do is have Foozle execute TrUMP immediately
  4293.                after  an  area  has  been  renumbered,  passing it Foozle's
  4294.                special  renumber  area  and  the  directory  that  has been
  4295.                renumbered.  It is absolutely essential that you have Foozle
  4296.                setup in this manner, else  lastread  pointers  will  not be
  4297.                accurate after a renumber.
  4298.  
  4299.  
  4300.  
  4301.  
  4302.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  4303.  
  4304.  
  4305.  
  4306.  
  4307.  
  4308.           TransAmiga BBS User Manual                                Page 67
  4309.  
  4310.  
  4311.                NOTE 1:  Every time you renumber, TransAmiga must rescan the
  4312.                message areas or it will have incorrect values  for the high
  4313.                and low  message number.   For this reason, you should never
  4314.                renumber when users are  online, even  if the  message areas
  4315.                have  been  locked  with  TrAL,  wait until after a user has
  4316.                logged  off  and  ensure  that  no   one  calls   while  the
  4317.                renumbering  is  taking  place.    If  you  exit then re-run
  4318.                TransAmiga after  every  call,  the  message  areas  will be
  4319.                scanned when it starts up; if you have TransAmiga waiting on
  4320.                its ARexx port, then  you must  send it  the RESCAN command.
  4321.                Remember also to run TrUMP right after the renumbering
  4322.  
  4323.                NOTE 2:  This only applies to actual renumbering of message,
  4324.                not just the deletion of older messages.
  4325.  
  4326.  
  4327.           Offline Message Readers:
  4328.  
  4329.                The message  format used  by TransAmiga  conforms exactly to
  4330.                what is outlined in FTS-0001.  Therefore, any message reader
  4331.                that  uses  this  message  format  should  be  usable  in  a
  4332.                TransAmiga FidoNet  environment, such as Chameleon, GCCHost,
  4333.                PointManager  and  RMB  (the  package  Juliet  uses  its own
  4334.                message  format   which  is   completely  incompatible  with
  4335.                TransAmiga).
  4336.  
  4337.                TransAmiga also has  special  support  for  the  Foozle Mail
  4338.                Manipulation System  by Peer Hasselmeyer.  Foozle is a super
  4339.                fast shareware integrated FidoNet  message  reader  and mail
  4340.                processor.   Foozle supports a custom message format that is
  4341.                a  variant  of  the   FTS-0001  format.     TransAmiga  will
  4342.                automatically recognize  a Foozle  message, and  read in the
  4343.                extra  header  information  that  Foozle  messages  contain.
  4344.                TransAmiga  still  writes  messages in the standard FTS-0001
  4345.                format, so Foozle users will have to use  its RESCAN command
  4346.                before it  does anything  else with the message areas, since
  4347.                Foozle will  not automatically  recognize FTS-0001 messages.
  4348.                Also,  Foozle  does  not  update  the  TransAmiga  last read
  4349.                pointers, so the TrUMP utility described above must do this.
  4350.                This does  not end  up being  any different  than with other
  4351.                mail processors, as TrUMP  has  to  be  run  anyway  after a
  4352.                renumber.
  4353.  
  4354.  
  4355.           Using FidoNet:
  4356.  
  4357.                Using FidoNet  simply involves  reading and writing messages
  4358.                in FidoNet areas.  This is  basically the  same as  in local
  4359.  
  4360.  
  4361.  
  4362.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  4363.  
  4364.  
  4365.  
  4366.  
  4367.  
  4368.           TransAmiga BBS User Manual                                Page 68
  4369.  
  4370.  
  4371.                and all-privileged areas, except that extra FidoNet specific
  4372.                information is inserted into the messages.
  4373.  
  4374.                When entering messages in a Matrix  area, you  will first be
  4375.                asked for  the FidoNet  address you wish to send the message
  4376.                to.    When  you  enter  a  valid  address,  TransAmiga will
  4377.                automatically look up this address in the nodelist, and when
  4378.                entering the name of who you  wish to  send the  message to,
  4379.                the default  name will  be the SysOp of that node (of course
  4380.                you can edit this).
  4381.  
  4382.                Netmail is by default  sent routed.   TransAmiga  leaves the
  4383.                topic of  netmail routing up to your mail processor (GCCHost
  4384.                and Foozle have routing capabilities built in, CM users will
  4385.                need to use oMMM to route netmail), however privileged users
  4386.                are given additional control.  If you're privileged you will
  4387.                also  be  asked  if  you  would  like  to  send  the message
  4388.                "Routed", "Crash Mail", "Hold" or to  send a  "File Attach".
  4389.                Most mail  processors will look at their routing information
  4390.                to determine what happens  to mail  marked as  routed, while
  4391.                crash mail  will always be sent directly to its destination,
  4392.                and mail put on hold will not be delivered, but  rather kept
  4393.                until  the  destination  node  contacts  your  system.  File
  4394.                attaches sends a file of your choice along  with the message
  4395.                and are always marked crash.
  4396.  
  4397.                Before a user can actually send the message, TransAmiga will
  4398.                check the cost of  sending  the  message  against  the users
  4399.                netmail credit.  The user will not be able to send a message
  4400.                if he/she does not have adequate credit.  Remember, in order
  4401.                to keep track of costs correctly, the message cost for nodes
  4402.                that you route  mail  to  should  be  set  to  zero  in your
  4403.                nodelist processor configuration.
  4404.  
  4405.  
  4406.  
  4407.  
  4408.  
  4409.  
  4410.  
  4411.  
  4412.  
  4413.  
  4414.  
  4415.  
  4416.  
  4417.  
  4418.  
  4419.  
  4420.  
  4421.  
  4422.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  4423.  
  4424.  
  4425.  
  4426.  
  4427.  
  4428.           TransAmiga BBS User Manual                                Page 69
  4429.  
  4430.  
  4431.  
  4432.  
  4433.                                     P A R T  V I
  4434.                                     ------------
  4435.  
  4436.  
  4437.  
  4438.  
  4439.                                 TransAmiga and ARexx
  4440.  
  4441.  
  4442.           Introduction:
  4443.  
  4444.                Arexx is  a very  powerful macro  language available for the
  4445.                Amiga.  If you have Release 2, then you already  have ARexx,
  4446.                otherwise you will need to purchase ARexx.
  4447.  
  4448.                If you  do not  have ARexx, then you are missing out on some
  4449.                of  TransAmiga's  most  powerful   features.    Nonetheless,
  4450.                TransAmiga does  make attempts to compensate for this and is
  4451.                still fully functional.   However, it  is highly recommended
  4452.                that  you  upgrade  to  Release  2  of the Amiga's operating
  4453.                system, which comes with ARexx.
  4454.  
  4455.                No lessons will be  given in  programming in  ARexx, but for
  4456.                those not familiar with it, ARexx is an interpreted language
  4457.                that includes the ability  to  send  commands  to  any other
  4458.                running  programme  that  has  opened a suitable ARexx port.
  4459.                With a little imagination,  tremendous  things  can  be done
  4460.                through ARexx.
  4461.  
  4462.  
  4463.           Using ARexx with TransAmiga:
  4464.  
  4465.                It is  TransAmiga's extensive ARexx interface that makes the
  4466.                BBS so powerful.  It allows you to  easily programme  in new
  4467.                functions in  addition to the built in ones.  You can change
  4468.                the  way  existing  commands  work,  add  new  commands, and
  4469.                basically  anything   you  want.    It  makes  TransAmiga  a
  4470.                completely programmable BBS.
  4471.  
  4472.                You will probably find that after setting up  the BBS, ARexx
  4473.                will soon start to play a very important role in the running
  4474.                of your BBS.  The ability  to customize,  and the  ease with
  4475.                which you can customize, are so great that you will probably
  4476.                find yourself relying on ARexx to make the  BBS act  the way
  4477.                you want it.
  4478.  
  4479.  
  4480.  
  4481.  
  4482.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  4483.  
  4484.  
  4485.  
  4486.  
  4487.  
  4488.           TransAmiga BBS User Manual                                Page 70
  4489.  
  4490.  
  4491.                At first  you may feel that having to use ARexx like this is
  4492.                too much work, and  that the  BBS should  be able  to handle
  4493.                more things  without ARexx.   However,  in order to maximize
  4494.                the SysOp's ability to make his/her own decisions  about the
  4495.                way his/her board appears, ARexx must be used, otherwise you
  4496.                would  always  be  running  into  limitations   of  the  BBS
  4497.                software.   After writing  a few ARexx macros yourself, once
  4498.                you get the hang of it, you will see the  enormous potential
  4499.                the TransAmiga's ARexx interface offers.
  4500.  
  4501.                When  TransAmiga  starts  up,  it opens an ARexx port called
  4502.                'TransAmiga.<line  number>'  where  it   can  receive  ARexx
  4503.                commands.    TransAmiga  sports  over 90 ARexx commands that
  4504.                allow you to access virtually every  single function  of the
  4505.                BBS.
  4506.  
  4507.                By convention,  all TransAmiga ARexx scripts should end with
  4508.                the '.trans' suffix so that they can easily be recognized as
  4509.                ARexx scripts for use with TransAmiga.  All TransAmiga ARexx
  4510.                scripts must reside in your BBS ARexx directory.
  4511.  
  4512.                There are two ways  to get  TransAmiga to  run ARexx macros.
  4513.                One way  is as  the cause  of a  user action.   For example,
  4514.                after logging on, the ARexx macro 'Logon.trans' is run.  The
  4515.                second way is by installing an ARexx macro as a command on a
  4516.                menu in  TransAmiga  using  the  special  .Rx  files  in the
  4517.                TransAmiga configurations directory.
  4518.  
  4519.                The  following  ARexx  macros  are  started  because of user
  4520.                actions:
  4521.  
  4522.                  Logon.trans       - after displaying the Title text file. 
  4523.                  Join.trans        - after  the  user   has   answered  the
  4524.                                    questions for the Join command.
  4525.                  File.trans        - when a  user tries  to go  to the file
  4526.                                    area.
  4527.                  Message.trans     - when a user tries to go to the message
  4528.                                    area.
  4529.                  Editor.trans      - immediately  after  the user exits the
  4530.                                    editor.  The text  entered can  be found
  4531.                                    in   t:Editor.Temp   (for   line  0)  or
  4532.                                    t:Editor_<line  number>.Temp  (for  line
  4533.                                    numbers other than 0).
  4534.                  GoodBye.trans     - after  a  user  selects  the  good-bye
  4535.                                    command.
  4536.                  LogOff.trans      - after  the  user  has   actually  been
  4537.                                    logged off.
  4538.  
  4539.  
  4540.  
  4541.  
  4542.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  4543.  
  4544.  
  4545.  
  4546.  
  4547.  
  4548.           TransAmiga BBS User Manual                                Page 71
  4549.  
  4550.  
  4551.                None of  these are required, and TransAmiga will first check
  4552.                to see if they  are present  before trying  to execute them.
  4553.                If they are not present, TransAmiga has some default actions
  4554.                that it will take.  If  the Logon.trans  ARexx macro  is not
  4555.                there, then the user will shown a list of new message posted
  4556.                since his/her last call, and also be prompted  to search for
  4557.                new  messages  sent  to  him/her.    If  the  File.trans  or
  4558.                Message.trans macros are not  found, then  the user  will be
  4559.                shown the list of available areas, and be prompted to select
  4560.                one.  If the  GoodBye.trans macro  is not  present, then the
  4561.                user will  be asked  if he/she wishes to change the one-line
  4562.                comment.
  4563.  
  4564.                To add an ARexx macro  as  a  command  from  a  menu, simply
  4565.                create an  .Rx file for that menu.  The format for these .Rx
  4566.                files is exactly the same as the .Cmds  files use  to set up
  4567.                commands, described  earlier, and the filenames are the same
  4568.                too, except that they end in .Rx rather than .Cmds.   It has
  4569.                the key used for the command, followed by the text string to
  4570.                be associated  with the  command, followed  the access level
  4571.                required, followed  by the  flags.  What makes the .Rx files
  4572.                different is  one  additional  field  that  comes  after the
  4573.                access level  with a space inbetween.  Here you put the name
  4574.                of the ARexx macro to be executed when  a user  selects this
  4575.                command from the menu.  For example:
  4576.  
  4577.                  ; Lines beginning with semi-colons are comments.
  4578.                  ; Blank lines are ignored, all other lines are assumed
  4579.                  ; to be ARexx command entries.
  4580.  
  4581.                  ; ********************** *** ******** *******************
  4582.                  P Poker                   10 X------- Poker.trans
  4583.                  W Wheel of Fortune        10 X------- Wheel.trans
  4584.                  Y Add to BBS Listing      10 X------- BBS_Lister.trans
  4585.  
  4586.                  ; THE END
  4587.  
  4588.                Be sure  that the  ARexx macro you specify is indeed a valid
  4589.                ARexx macro in your BBS ARexx  directory, otherwise  the BBS
  4590.                could be hung waiting for ARexx messages coming from a macro
  4591.                that was never run.
  4592.  
  4593.  
  4594.           Writing ARexx Macros:
  4595.  
  4596.                Every single ARexx macro you write for TransAmiga  must have
  4597.                the line  'options results',  otherwise the  macros will not
  4598.                function properly.  This tells TransAmiga that it  is OK for
  4599.                it to  send return codes back to ARexx.  As TransAmiga needs
  4600.  
  4601.  
  4602.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  4603.  
  4604.  
  4605.  
  4606.  
  4607.  
  4608.           TransAmiga BBS User Manual                                Page 72
  4609.  
  4610.  
  4611.                to set return codes for many of its commands, this line must
  4612.                exist in each and every TransAmiga ARexx macro.
  4613.  
  4614.                Secondly,  you  must  be  able  to  handle  unexpected  user
  4615.                logoffs, due to either dropping carrier or an  idle timeout.
  4616.                There are  two ways  to handle  this: when a command returns
  4617.                something in the result variable, such as when  querying the
  4618.                user for a string, TransAmiga will update the ARexx variable
  4619.                CARRIER.  If the user is  still  online,  it  will  hold the
  4620.                value  of  1,  otherwise,  it  will  equal  0.  All properly
  4621.                written ARexx  macro must  check this  regularly and respond
  4622.                appropriately.
  4623.  
  4624.                TransAmiga ARexx  macros need  no 'address' line in them, as
  4625.                the port is set to TransAmiga's when the macro is started.
  4626.  
  4627.                ARexx macros started  by  TransAmiga  do  not  need  to, and
  4628.                should not,  address TransAmiga's  ARexx port, as TransAmiga
  4629.                sets this before the macro  is  started.    However,  if you
  4630.                start up  an ARexx macro from another source (eg. the shell)
  4631.                that is to  talk  to  TransAmiga,  you  will  first  need to
  4632.                address  the  name  of  TransAmiga's ARexx port.  TransAmiga
  4633.                opens  a  different  ARexx   port  for   each  line,  called
  4634.                'TransAmiga.#'  where  #  is  the  line number, eg. line 1's
  4635.                ARexx port  will  be  called  'TransAmiga.1'.    Since ARexx
  4636.                converts  all  unquoted  strings  to  upper-case,  you  must
  4637.                enclose the port name in quotation marks.
  4638.  
  4639.                From then on, all  you have  to know  are the  special ARexx
  4640.                commands  that  TransAmiga  understands.    As you will see,
  4641.                there is a very large variety.
  4642.  
  4643.  
  4644.           TransAmiga v1.0x Doors:
  4645.  
  4646.                The original versions of TransAmiga had only the  most basic
  4647.                of door  support, where  a door  was simply  a DOS programme
  4648.                that was  run,  and  no  interaction  between  the  door and
  4649.                TransAmiga could  take place.   Nonetheless, some doors were
  4650.                written, most  notably  PTA  by  James  Stewart  for running
  4651.                Paragon BBS doors.
  4652.  
  4653.                Doors  in  TransAmiga  v1.0x  were added as command to menus
  4654.                using the .Exts files, but they are now gone.  Now, you must
  4655.                have  an  ARexx  macro  installed  as a command which inturn
  4656.                starts the  v1.0x  door  using  the  RUNDOOR  ARexx command.
  4657.                TransAmiga v1.1  creates the  old-style t:Door.Temp file for
  4658.                complete compatibility (new doors  should no  longer use the
  4659.                t:Door.Temp file, but should instead get information through
  4660.  
  4661.  
  4662.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  4663.  
  4664.  
  4665.  
  4666.  
  4667.  
  4668.           TransAmiga BBS User Manual                                Page 73
  4669.  
  4670.  
  4671.                TransAmiga's ARexx port).  Note also  that the  name of this
  4672.                file depends on which line starts the door.
  4673.  
  4674.                Here is a sample ARexx macro for starting a door via PTA:
  4675.  
  4676.                  /* GlobalWar.trans, starts GlobalWar through PTA */
  4677.  
  4678.                  options results
  4679.  
  4680.                  PRINT 'Loading Global War...'
  4681.                  RUNDOOR 'BBS:PTA -s BBS:Extras/GlobalWar/GlobalWar'
  4682.  
  4683.                  exit
  4684.  
  4685.  
  4686.           ARexx Macro Ideas:
  4687.  
  4688.                Because  of  the  vastness  of  the  commands  available  in
  4689.                TransAmiga through ARexx,  you  are  virtually  unlimited in
  4690.                what you can do.
  4691.  
  4692.                One  of  the  most  popular applications is online games, as
  4693.                these are quite popular with many BBS callers.  TransAmiga's
  4694.                ARexx interface  is ideally  suited to easily writing games,
  4695.                but there is far more that you can do.  Here are  some ideas
  4696.                you may wish to think about:
  4697.  
  4698.                 * A callback verification programme for auto-validating new
  4699.                users.
  4700.                 * Personal file space for  users,  so  that  two  users can
  4701.                exchange files privately.
  4702.                 *  Division  of  file  and  message  areas  into sub-groups
  4703.                (sometimes called SIGs).
  4704.                 * A polling booths  for users  to create  and vote  on poll
  4705.                topics.
  4706.  
  4707.  
  4708.  
  4709.  
  4710.  
  4711.  
  4712.  
  4713.  
  4714.  
  4715.  
  4716.  
  4717.  
  4718.  
  4719.  
  4720.  
  4721.  
  4722.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  4723.  
  4724.  
  4725.  
  4726.  
  4727.  
  4728.           TransAmiga BBS User Manual                                Page 74
  4729.  
  4730.  
  4731.                                   Command Reference
  4732.  
  4733.  
  4734.  
  4735.           Introduction:
  4736.  
  4737.                This sections  lists all  the ARexx commands that TransAmiga
  4738.                understands.  Many of them will return values  of some sort.
  4739.                You ARexx  macro can  look at these values by evaluating the
  4740.                variable RESULT.
  4741.  
  4742.                TransAmiga's ARexx interface is  divided  into  two  sets of
  4743.                commands: The  first set, used most often, is made up of the
  4744.                commands used when TransAmiga starts an  ARexx macro  when a
  4745.                user is  online.   The second  set, which  are only used for
  4746.                special situations such as running a FidoNet node,  are ones
  4747.                that are  only understood  when TransAmiga  has been started
  4748.                with the -r option and a user is not currently online.
  4749.  
  4750.                The online commands can  be further  divided into TransAmiga
  4751.                specific commands,  and the ABBEREXX commands and variables.
  4752.                The ABBEREXX commands are  actually  a  standardized  set of
  4753.                commands  used  by  several different BBS packages, allowing
  4754.                ARexx macros written for  different  systems  to  be  run by
  4755.                TransAmiga.   If you  want your  macros to  be run by SysOps
  4756.                using other BBS packages, then you  should restrict yourself
  4757.                to the ABBEREXX command and variable set.  However, for most
  4758.                applications, you may find it desirable  to make  use of the
  4759.                multitude  of  additional  TransAmiga specific commands that
  4760.                are  available,  with  the   consequence  being   that  only
  4761.                TransAmiga systems will be able handle these macros.
  4762.  
  4763.  
  4764.           ABBEREXX Commands:
  4765.  
  4766.                These are the commands that TransAmiga supports as a part of
  4767.                the Amiga Bulletin Board External Rexx  (ABBEREXX) interface
  4768.                command set.  These commands should be used when portability
  4769.                to other ARexx supporting BBS's is desired.
  4770.  
  4771.                BBSIDENTIFY ABBEREXX BBS|EMULATION|NAME|SYSOP|TERM|USER -
  4772.                Returns  certain   information,  depending   on  the  <what>
  4773.                parameter.  Possible values are:
  4774.                  ABBEREXX:  which   returns  the  current  version  of  the
  4775.                ABBEREXX implementation (at the moment, '1.0').
  4776.                  BBS: which  returns the  current version  of TransAmiga is
  4777.                being used.
  4778.                  EMULATION: indicates what type of terminal mode the caller
  4779.                has selected.  It returns either 'ASCII' or 'ANSI'.
  4780.  
  4781.  
  4782.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  4783.  
  4784.  
  4785.  
  4786.  
  4787.  
  4788.           TransAmiga BBS User Manual                                Page 75
  4789.  
  4790.  
  4791.                  NAME: returns the name you have set for the BBS.
  4792.                  SYSOP: returns the name of the SysOp of the BBS.
  4793.                  TERM: which returns a string of  the format  <baud> <rows>
  4794.                <columns> <line number>, eg. 2400 80 24 0.
  4795.                  USER, which  returns a  string of  the format "<username>"
  4796.                "<calling from>" <access>, where access is one of:  GUEST (a
  4797.                first  time  caller,  access  0), MEMBER (anyone with access
  4798.                greater than 0 and less than  the privileged  access level),
  4799.                CO-SYSOP  (anyone  with  access  equal  to  or  greater than
  4800.                privileged access, but  less  than  255),  or  SYSOP (access
  4801.                255).   An example  return string could be: "Tim Aston" "St.
  4802.                Catharines, Ont." MEMBER
  4803.  
  4804.                eg:  BBSIDENTIFY ABBEREXX
  4805.                     BBSIDENTIFY BBS
  4806.                     BBSIDENTIFY EMULATION
  4807.                     BBSIDENTIFY NAME
  4808.                     BBSIDENTIFY SYSOP
  4809.                     BBSIDENTIFY TERM
  4810.                     BBSIDENTIFY USER
  4811.  
  4812.                CHECKABORT -
  4813.                Returns 1 if the user has  pressed  one  of  the  abort keys
  4814.                (CTRL-C or the spacebar), otherwise 0.  Takes no parameters.
  4815.  
  4816.                CLS -
  4817.                Sends  the  screen  clearing  code.  Takes no parameters and
  4818.                returns nothing.
  4819.  
  4820.                GETCHAR -
  4821.                Waits for a single character from the user.   It  returns as
  4822.                soon as it gets something, and does not wait for the user to
  4823.                press RETURN.  It  takes  no  arguments,  and  the character
  4824.                received  will  be  returned,  or '###PANIC' if the user was
  4825.                unexpectedly logged off due to carrier loss, timeout, etc.
  4826.  
  4827.                HANGUP -
  4828.                Hangs the  online  caller  up,  and  after  the  ARexx macro
  4829.                terminates, the  logoff procedure  will be initiated.  Note,
  4830.                that if it is a local logon, nothing  actually happens until
  4831.                the ARexx macro terminates.  Takes no parameters and returns
  4832.                nothing.
  4833.  
  4834.                IREADY -
  4835.                If there  is any  input waiting  in the  serial buffer, this
  4836.                command returns  1, else  0.   No input is retrieved though.
  4837.                It takes no parameters.
  4838.  
  4839.                MAYGETCHAR -
  4840.  
  4841.  
  4842.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  4843.  
  4844.  
  4845.  
  4846.  
  4847.  
  4848.           TransAmiga BBS User Manual                                Page 76
  4849.  
  4850.  
  4851.                Checks if they user has  entered  a  character,  and returns
  4852.                immediately, with  the result  being either the key the user
  4853.                pressed or 'NOCHAR' if a key  was  not  pressed.    Takes no
  4854.                parameters.
  4855.  
  4856.                eg:  MAYGETCHAR
  4857.                     cmd=RESULT
  4858.                     if cmd~='NOCHAR' then call do_cmd
  4859.  
  4860.                NEWLINE -
  4861.                Sends the newline code (a carriage return followed by a line
  4862.                feed).  Takes no parameters and returns nothing.
  4863.  
  4864.                PRINT <string> -
  4865.                Sends the given string with a newline appended.   It returns
  4866.                nothing.
  4867.  
  4868.                PROMPT <length> NORMAL|HIDE|YESNO|NOYES "<prompt>" -
  4869.                Prompts the  user to enter text with the given length as the
  4870.                maximum.  Three types of text input are currently supported:
  4871.                  NORMAL: Normal line oriented input
  4872.                  HIDE: As above, but  hid  user  input  behind  dashes (-).
  4873.                Useful for passwords, etc.
  4874.                  YESNO: A Yes or No response, with Yes as the default.
  4875.                  NOYES: A Yes or No response, with No as the defalut.
  4876.                The prompt text must be enclosed in quotes, an din order for
  4877.                the BBS to  "see"  these  quotes,  they  themselves  must be
  4878.                quoted (see examples).
  4879.  
  4880.                This  command  returns  the  string  entered in the cases of
  4881.                NORMAL and HIDE types, and either  'Y' or  'N' in  the cases
  4882.                the YESNO and NOYES types.
  4883.  
  4884.                eg:  PROMPT 30 'NORMAL' '"Enter your favourite colour: "'
  4885.                     PROMPT 10 'HIDE' '"Where were YOU last night?'"
  4886.                     PROMPT 1 'YESNO' '"Was it good for you?'"
  4887.  
  4888.                SEND <string> -
  4889.                Sends the  given string  exactly as  is to the user, with no
  4890.                translation or screening done on the part of TransAmiga.  It
  4891.                returns nothing.
  4892.  
  4893.                SENDFILE <filename> -
  4894.                Sends  the  given  text  file  to  the online user, the full
  4895.                pathname must be given.  More? prompts will automatically be
  4896.                displayed  as  usual,  and  all  TransAmiga imbedded control
  4897.                codes are available as usual.  If the current user  has ANSI
  4898.                turned on,  it will first look for <filename>.ANSI, and fall
  4899.  
  4900.  
  4901.  
  4902.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  4903.  
  4904.  
  4905.  
  4906.  
  4907.  
  4908.           TransAmiga BBS User Manual                                Page 77
  4909.  
  4910.  
  4911.                back to the original filename if  that  is  not  found.   It
  4912.                returns nothing.
  4913.  
  4914.                eg: SENDFILE 'BBS:Text/Title'
  4915.  
  4916.                SETNODELOCATION <where> -
  4917.                This allows  you to  change the string that indicates what a
  4918.                user is doing that is displayed  with the  List Online Users
  4919.                command, or the TrBLAD programme.
  4920.  
  4921.                eg:  SETNODELOCATION 'Playing "Kill the Capitalists"'
  4922.  
  4923.                SYSOPLOG <string> -
  4924.                Creates a  log entry  with the  given string.   The date and
  4925.                time will  automatically  be  added  infront.    It  will be
  4926.                appended to TransAmiga's log file.  It returns nothing.
  4927.  
  4928.                eg:  SYSOPLOG 'Lost all his/her money at poker'
  4929.  
  4930.  
  4931.           ABBEREXX Variables:
  4932.  
  4933.                Part of  the ABBEREXX  standard is  the maintenance of three
  4934.                ARexx  variables.    These  are:  CARRIER,   TIMEONLINE  and
  4935.                TIMELEFT.  CARRIER, as explained above, indicates whether or
  4936.                not there is a user online line, it contains the  value 1 if
  4937.                a  user  is  online,  0  otherwise.  TIMEONLINE and TIMELEFT
  4938.                indicate, in minute, how much time the user has spent online
  4939.                today  and   how  much   time  he/she  has  left  for  today
  4940.                respectively.
  4941.  
  4942.                eg:  PRINT 'You've used' TIMEONLINE 'minutes today'
  4943.                     QUERY 'How do you feel about that?'
  4944.                     answer=RESULT
  4945.  
  4946.                     if CARRIER=0 then do
  4947.                          SYSOPLOG 'Carrier Drop!'
  4948.                          exit 10
  4949.                     end
  4950.                     if timeleft<=0 then do
  4951.                          SYSOPLOG 'No more time!'
  4952.                          exit 10
  4953.                     end
  4954.  
  4955.  
  4956.           Commands Recognized with a Caller Online:
  4957.  
  4958.                These are the commands that TransAmiga  supports in addition
  4959.                to the ABBEREXX commands while there is a user online.
  4960.  
  4961.  
  4962.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  4963.  
  4964.  
  4965.  
  4966.  
  4967.  
  4968.           TransAmiga BBS User Manual                                Page 78
  4969.  
  4970.  
  4971.  
  4972.                BROWSEFILES <mode> -
  4973.                Allows  you  to  select  either  browse  or regular mode for
  4974.                listing files.  A mode  value  of  0  indicates  normal mode
  4975.                while  a  value  of  1  switches  to  browse  mode.  Returns
  4976.                nothing.
  4977.  
  4978.                CHARSTACK -
  4979.                This checks if there  is anything  in the  current character
  4980.                stack, i.e.  whether or  not the  user has  "stacked" one or
  4981.                more commands.  Returns 1 if  there  is,  otherwise  0.   It
  4982.                takes no parameters.
  4983.  
  4984.                eg:  CHARSTACK
  4985.                     if RESULT=0 then SENDMENU 'BBS:Text/MyMenu'
  4986.  
  4987.                CHECKMSGS -
  4988.                Does a search of all new messages in all available areas for
  4989.                messages addressed to the user or  to the  user's handle (if
  4990.                he/she has one).  Found messages will be marked.  The search
  4991.                can be  aborted  at  any  time  by  pressing  CTRL-C  or the
  4992.                spacebar.
  4993.  
  4994.                CONTINUE -
  4995.                Brings up  the "Press RETURN to continue." prompt and awaits
  4996.                a response from the user.  It takes no arguments and returns
  4997.                nothing.
  4998.  
  4999.                ECHOMAIL -
  5000.                Returns 'TRUE' if echomail has been entered this call by the
  5001.                user, or 'FALSE' if not.
  5002.  
  5003.                eg:  ECHOMAIL
  5004.                     if RESULT='TRUE' then call export_echo
  5005.  
  5006.                FEEDBACK -
  5007.                Functionally identical to the  function from  the Main Menu.
  5008.                Takes no parameters and returns nothing.
  5009.  
  5010.                FILEAREA <area number> -
  5011.                Changes  to  the  specified  file  area.   If the change was
  5012.                successful, 1  is  returned,  otherwise  0,  indicating that
  5013.                either in invalid area number was given or that the user did
  5014.                not have sufficient access.
  5015.  
  5016.                GETCARRIER -
  5017.                Checks to see whether  carrier is  present or  not.  Returns
  5018.                either TRUE of FALSE.  It takes no arguments.
  5019.  
  5020.  
  5021.  
  5022.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  5023.  
  5024.  
  5025.  
  5026.  
  5027.  
  5028.           TransAmiga BBS User Manual                                Page 79
  5029.  
  5030.  
  5031.                GETCMD [<prompt>] -
  5032.                This command  works in  much the same way as GETCHAR, except
  5033.                that if  the user  does not  have hotkeys  selected, it will
  5034.                wait for  the user  to press RETURN.  Any surplus characters
  5035.                entered by the user will be kept in his/her command stacking
  5036.                buffer.  You can optionally supply a prompt string for it to
  5037.                display before waiting for the command.  The command entered
  5038.                will be  translated to  uppercase automatically.  It returns
  5039.                the  character  received  or  '###PANIC'  in   the  case  of
  5040.                unexpected logoff (due to carrier loss, timeout, etc).
  5041.  
  5042.                JOIN -
  5043.                Takes a  user through  the process  of joining the board, in
  5044.                the exact same way as the Join command  from the  Main Menu.
  5045.                Takes no parameters and returns nothing.
  5046.  
  5047.                LISTFILEAREAS -
  5048.                This command  lists all  file areas  the user has access to,
  5049.                two areas  per line,  with each  area numbered.   It returns
  5050.                nothing and takes no arguments.
  5051.  
  5052.                LISTFILES -
  5053.                Lists the  files in the current file area, giving a total at
  5054.                the  bottom.    More?  prompts  will  be  brought   up  when
  5055.                necessary, and  the user  can abort  the listing by pressing
  5056.                CTRL-C or SPACE.  It takes no arguments and returns nothing.
  5057.  
  5058.                LISTMSGAREAS -
  5059.                Lists all message areas the user has access to, two per line
  5060.                with each  area numbered.  It takes no arguments and returns
  5061.                nothing.
  5062.  
  5063.                LISTONLINE -
  5064.                Displays  the  current  BBS  online  activity.     Takes  no
  5065.                parameters and returns nothing.
  5066.  
  5067.                LISTPROTOCOLS -
  5068.                Displays the  available file  transfer protocols to the user
  5069.                along with their corresponding  number.   Takes no arguments
  5070.                and returns nothing.
  5071.  
  5072.                LISTUSERS -
  5073.                Functionally identical  to the  function from the Main Menu.
  5074.                Returns nothing and takes no parameters.
  5075.  
  5076.                LOADLANGUAGE <language> -
  5077.                Loads in a new language file,  over-riding the  current one.
  5078.                The  language  file  is  searched  for in the configurations
  5079.  
  5080.  
  5081.  
  5082.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  5083.  
  5084.  
  5085.  
  5086.  
  5087.  
  5088.           TransAmiga BBS User Manual                                Page 80
  5089.  
  5090.  
  5091.                directory, and the  extension  .Lang  will  automatically be
  5092.                added.  Returns nothing.
  5093.  
  5094.                eg:  LOADLANGUAGE "francais"
  5095.  
  5096.                MARKFILE <filename> -
  5097.                Marks the  given filename if less than 10 have are currently
  5098.                marked.  It will  scan all  file libraries  available to the
  5099.                user for  the file,  it need  not be in the current library.
  5100.                Returns the full path to the marked file,  or 'FAIL'  if the
  5101.                file could not be found.
  5102.  
  5103.                eg:  QUERY 'Enter file to mark: ' ; file=RESULT
  5104.                     if CARRIER=1 then do
  5105.                          MARKFILE file
  5106.                          if RESULT='FAIL' then PRINT 'Not found!'
  5107.                     end
  5108.  
  5109.                MARKMSG <number> -
  5110.                Marks the  given message  number in  the current conference.
  5111.                Returns nothing.
  5112.  
  5113.                MODEMCMD <string> -
  5114.                Sends the  given string  to the  modem, and  will expand the
  5115.                imbedded control  code ~ to equal a half second pause, and |
  5116.                to equal a carriage return.
  5117.  
  5118.                eg: MODEMCMD '~~~+++~~~ATH|~~'
  5119.  
  5120.                MORE -
  5121.                Brings up the More -Y/N/C- prompt and waits  for user input.
  5122.                TransAmiga does  no checking  on what the user enters, it is
  5123.                up to the ARexx macro to do this.  It takes no arguments.
  5124.  
  5125.                MSGAREA <area number> -
  5126.                Changes to the specified  message area.   If  the change was
  5127.                successful,  1  is  returned,  otherwise  0, indicating that
  5128.                either in invalid area number was given or that the user did
  5129.                not have sufficient access.
  5130.  
  5131.                NETMAIL -
  5132.                Returns 'TRUE'  if netmail has been entered this call by the
  5133.                user, or 'FALSE' if not.
  5134.  
  5135.                eg:  NETMAIL
  5136.                     if RESULT='TRUE' then call export_matrix
  5137.  
  5138.                NEWMSGS -
  5139.  
  5140.  
  5141.  
  5142.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  5143.  
  5144.  
  5145.  
  5146.  
  5147.  
  5148.           TransAmiga BBS User Manual                                Page 81
  5149.  
  5150.  
  5151.                Displays the number of new messages that have been posted in
  5152.                each area  the user  has access  to since his/her last call.
  5153.                It takes no arguments and returns nothing.
  5154.  
  5155.                NEWFILES -
  5156.                Prompts the  user at  what date  to start  searching for new
  5157.                files  from.    It  searches  all areas and will display new
  5158.                files to the  user.    It  takes  no  arguments  and returns
  5159.                nothing.
  5160.  
  5161.                NOP -
  5162.                NO OPeration, a do nothing command.
  5163.  
  5164.                PAGESYSOP -
  5165.                Writes to  the Status  Window and  the log that the user has
  5166.                paged, it will not beep.  It takes no arguments  and returns
  5167.                nothing.
  5168.  
  5169.                PROTOCOLSEND <files...> -
  5170.                Sends  the  given  files  using  the  current  file transfer
  5171.                protocol.   The full-path  name of  the file  must be given,
  5172.                TransAmiga will  not search  for the file in the file areas.
  5173.                Note  that  although  several  files  can  be  passed,  some
  5174.                protocols are  non-batch and  will only send the first file.
  5175.                Also  note  that   a   user's   current   protocol   may  be
  5176.                unpredictable unless the SETPROTOCOL command has been used.
  5177.  
  5178.                QUERY [<prompt>][\\<default>] -
  5179.                This command  waits for  input from  the user.  The user may
  5180.                enter up to one line of text, and must terminate the line by
  5181.                pressing  RETURN.    If  a  prompt is supplied, this will be
  5182.                displayed immediately before waiting  for input.   A default
  5183.                for user  input can  be specified  by having two backslashes
  5184.                (\\) immediately after  the  prompt  text,  followed  by the
  5185.                desired default  input.  The default input will be displayed
  5186.                for the user to edit.  The string entered is returned.
  5187.  
  5188.                eg:  QUERY 'What planet do you live on: \\Earth'
  5189.                     planet=RESULT
  5190.  
  5191.                QUERYY [<prompt>] -
  5192.                This will prompt the user for a Yes or No response, with the
  5193.                default  being  Yes.    If  a prompt is supplied, it will be
  5194.                displayed  immediately   before  waiting   for  user  input.
  5195.                TransAmiga  translates  user  input  to upper case, but does
  5196.                nothing  else.    The  character  entered  by  the  user  is
  5197.                returned.
  5198.  
  5199.                eg:  QUERYY 'Are Amigas good computers?'
  5200.  
  5201.  
  5202.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  5203.  
  5204.  
  5205.  
  5206.  
  5207.  
  5208.           TransAmiga BBS User Manual                                Page 82
  5209.  
  5210.  
  5211.                     if RESULT='Y' then smart=1 else smart=0
  5212.  
  5213.                QUERYN [<prompt>] -
  5214.                This  is  exactly  the  same  as  the above, except that the
  5215.                default response it No.
  5216.  
  5217.                eg:  QUERYN 'Is the sky green?'
  5218.                     if RESULT='N' then smart=1 else smart=0
  5219.  
  5220.                READMODE <mode> -
  5221.                Selects the read mode for reading messages.  Current defined
  5222.                modes are  0 for  read all available messages, 1 for reading
  5223.                personal mail only, and 2 for reading marked  messages only.
  5224.                The read  mode is  always set  as 0  when the  user logs on.
  5225.                Returns nothing.
  5226.  
  5227.                READMARKEDMSGS -
  5228.                This cycles  through all  message conferences  that the user
  5229.                has access  to and  the marked messages.  This can be useful
  5230.                as a means of  immediately displaying  messages to  the user
  5231.                that have been found in some kind of search.
  5232.  
  5233.                READNEWMSGS -
  5234.                Starts reading  new messages in the current area, equivalent
  5235.                to the command from the message  menu.   Takes no parameters
  5236.                and returns nothing.
  5237.  
  5238.                RESCAN -
  5239.                Rescan  the  message  areas  for  the  high  and low message
  5240.                pointers.  This should be used if your  ARexx macro  has run
  5241.                TrUMP  to  adjust  the  message  pointers,  this  makes sure
  5242.                TransAmiga knows about these changes.
  5243.  
  5244.                RUNDOOR <cmd> -
  5245.                Starts a door using the given command.   Before the  door is
  5246.                saved, a  TransAmiga v1.0x  format door  information file is
  5247.                saved in T:, the name of which can  be passed  using %f (see
  5248.                below).  Several imbedded control codes are supported:
  5249.  
  5250.                  %b - Baud rate of the caller
  5251.                  %n - BBS line number
  5252.                  %f - Name of door info temporary file
  5253.                  %c - BBS master configuration file for this line
  5254.  
  5255.                The  command's  result  code  is  returned,  or  '-1' if the
  5256.                command could not be executed.
  5257.  
  5258.                eg:  RUNDOOR 'BBS:Extras/MyDoor/MyDoor -n%n -c%c'
  5259.  
  5260.  
  5261.  
  5262.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  5263.  
  5264.  
  5265.  
  5266.  
  5267.  
  5268.           TransAmiga BBS User Manual                                Page 83
  5269.  
  5270.  
  5271.                NOTE: This command is  only useful  some doors, particularly
  5272.                older  ones  designed  for  TransAmiga v1.0x, and doors that
  5273.                make minimal use of transamiga.library.  Most doors (such as
  5274.                TrMaint and  TrShell) will  need to  be started  up with the
  5275.                built-in ARexx command  "address  command  <cmd>".    For an
  5276.                example  of  starting  doors  this  way, see the examples of
  5277.                starting TrMaint and TrShell  from the  BBS, and  you should
  5278.                also look up "address command" in your ARexx documentation.
  5279.  
  5280.                Hopefully the door's documentation will clearly state how it
  5281.                should be started,  but  when  in  doubt,  use  the "address
  5282.                command" method.
  5283.  
  5284.                SAVEMSG <filename>\\<msg number> -
  5285.                This saves  the indicated  message number to the given file.
  5286.                Note that no checking is done to see  if the  user should be
  5287.                allowed  to  read  this  message.    The  filename  must  be
  5288.                immediately  followed  by  two   backslashes  (\\)  followed
  5289.                immediately  by  the  message  number.    Both arguments are
  5290.                required, nothing is returned.
  5291.  
  5292.                SEARCHFILES <search string> -
  5293.                Searches all file areas that the  user has  access to  for a
  5294.                file  that   has  the   given  string  in  its  filename  or
  5295.                description,  and  displays  those  files  to  the terminal.
  5296.                Returns nothing.
  5297.  
  5298.                SENDMENU <filename> -
  5299.                This  is  very  similar  to  the SENDFILE command.  The only
  5300.                differences are: the file is assumed to be  in the  BBS text
  5301.                directory (therefore,  you should not pass a full pathname);
  5302.                the file may be interrupted when it is being displayed  by a
  5303.                the  user  pressing  a  key,  which  is  taken  to be a menu
  5304.                command.  This command can then be retrieved using any input
  5305.                commands such  as GETCHAR, GETCMD, etc.; and TransAmiga will
  5306.                also attempt to see if there is a menu for the user's access
  5307.                level, in  exactly the  same way  as it does when displaying
  5308.                menu files.
  5309.  
  5310.                SETACCESS <access> -
  5311.                Changes the online user's access level  to the  given value.
  5312.                Returns nothing.
  5313.  
  5314.                SETALIAS <name> -
  5315.                Changes the online user's alias to the given value.  Returns
  5316.                nothing.
  5317.  
  5318.                SETBIRTH <date> -
  5319.  
  5320.  
  5321.  
  5322.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  5323.  
  5324.  
  5325.  
  5326.  
  5327.  
  5328.           TransAmiga BBS User Manual                                Page 84
  5329.  
  5330.  
  5331.                Changes the online  user's  birthdate  to  the  given value,
  5332.                which must be in YYMMDD format.  Returns nothing.
  5333.  
  5334.                SETCOMMENT <comment> -
  5335.                Changes  the  one-line  comment  to  the  given comment, and
  5336.                attributes it the current user (or to his/her  handle if the
  5337.                user has one).  Returns nothing.
  5338.  
  5339.                SETCITY <city> -
  5340.                Changes the  online user's city to the given value.  Returns
  5341.                nothings.
  5342.  
  5343.                SETCOMP <computer> -
  5344.                Changes the online user's computer type to the  given value.
  5345.                Returns nothing.
  5346.  
  5347.                SETEDITOR <editor type> -
  5348.                Sets the type of editor for the online user.  Values allowed
  5349.                currently are 0 for the internal line-editor, and  1 for the
  5350.                external full-screen  editor.   Note that TransAmiga does no
  5351.                checking here as to whether the user has ANSI active or not,
  5352.                so  beware  of  this  when setting people to the full-screen
  5353.                editor.  Returns nothing.
  5354.  
  5355.                SETFLAGS <flags> -
  5356.                Changes the access flags of  the  online  user.    Should be
  5357.                eight characters  long with  an X indicating the flag is set
  5358.                and a - indicating it is unset.  Returns nothing.
  5359.  
  5360.                SETGRAPHICS <graphics type> -
  5361.                Changes the  graphics  type  of  the  online  user.   Values
  5362.                allowed currently  are 0 for ASCII, and 1 for ANSI.  Returns
  5363.                nothing.
  5364.  
  5365.                SETHOTKEYS <boolean> -
  5366.                Changes the status of hotkeys for the online user.   0 turns
  5367.                them off, 1 turns them on.  Returns nothing.
  5368.  
  5369.                SETLASTREAD <number> -
  5370.                Changes the  user's last read pointer in the current message
  5371.                area to the given number.  Returns nothing.
  5372.  
  5373.                SETLENGTH <length> -
  5374.                Changes the screen length  of the  online user  to the given
  5375.                value.  Returns nothing.
  5376.  
  5377.                SETPHONE <tel. no.> -
  5378.                Changes the  phone number  of the  online user  to the given
  5379.                value.  Returns nothing.
  5380.  
  5381.  
  5382.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  5383.  
  5384.  
  5385.  
  5386.  
  5387.  
  5388.           TransAmiga BBS User Manual                                Page 85
  5389.  
  5390.  
  5391.  
  5392.                SETPOSTAL <postal code> -
  5393.                Changes the postal (or Zip) code of the  online user  to the
  5394.                given value.  Returns nothing.
  5395.  
  5396.                SETPROTOCOL <protocol number> -
  5397.                Changes  the  protocol  of  the  online  user  to  the given
  5398.                protocol number.  Note  that  TransAmiga  does  not actually
  5399.                save the user's selected protocol, so their current protocol
  5400.                may be unpredictable before using this command.
  5401.  
  5402.                SETPROV <province> -
  5403.                Changes the province (or territory or  state) of  the online
  5404.                user to the given value.  Returns nothing.
  5405.  
  5406.                SETPSWD <password> -
  5407.                Changes the  password of the online user to the given value.
  5408.                Returns nothing.
  5409.  
  5410.                SETRATIO <max. downloads> -
  5411.                Changes the maximum number  of files  the user  may download
  5412.                for each  upload to  the given value, which may be from 1 to
  5413.                255.  Returns nothing.
  5414.  
  5415.                SETSTREET <street> -
  5416.                Changes the street address of the  online user  to the given
  5417.                value.  Returns nothing.
  5418.  
  5419.                SETTIME <minutes remaining> -
  5420.                Changes the  amount of  online time the online users has for
  5421.                today.  Returns nothing
  5422.  
  5423.                SYSTEMINFO <character> -
  5424.                This returns the piece  of system  information corresponding
  5425.                to the  given character.   The  characters available are the
  5426.                same for the system information imbedded  control codes that
  5427.                area available  in text files, and the same information will
  5428.                be returned.  Use both this and the USERINFO command to find
  5429.                out  information  about  the  system  setup  and the current
  5430.                online user.
  5431.  
  5432.                An example of its usage would be to send 'SYSTEMINFO  7 ' to
  5433.                check the  access of  the current  file area,  to see if the
  5434.                user has access.
  5435.  
  5436.                eg: SYSTEMINFO b ; last_caller=RESULT
  5437.  
  5438.                TEXTEDIT -
  5439.  
  5440.  
  5441.  
  5442.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  5443.  
  5444.  
  5445.  
  5446.  
  5447.  
  5448.           TransAmiga BBS User Manual                                Page 86
  5449.  
  5450.  
  5451.                Calls the appropriate editor, depending on the user's editor
  5452.                choice, and  whether or not it is a local logon.  It returns
  5453.                the name of the  file that  contains the  text the  user has
  5454.                entered,  or  '###ABORTED'  if  the user aborted the editor.
  5455.                Takes no parameters.
  5456.  
  5457.                eg:  TEXTEDIT ; file=RESULT
  5458.                     if file~='###ABORTED' then
  5459.                          address command 'copy' file dir||'signature'
  5460.  
  5461.                USERINFO <character> -
  5462.                This returns the piece of user  information corresponding to
  5463.                the given  character.  The characters available are the same
  5464.                for the  user information  imbedded control  codes that area
  5465.                available in  text files,  and the  same information will be
  5466.                returned.  Use both this and the SYSTEMINFO  command to find
  5467.                out  information  about  the  system  setup  and the current
  5468.                online user.
  5469.  
  5470.                An example of its  usage would  be to  send 'USERINFO  x' to
  5471.                check  the  ANSI  status  of  the  user,  and  set some ANSI
  5472.                variables accordingly.
  5473.  
  5474.                eg:  USERINFO a ; name=RESULT
  5475.                     USERINFO 0 ; acc_level=RESULT
  5476.  
  5477.                VERSIONINFO -
  5478.                Displays the version information to the  user.   It takes no
  5479.                arguments and returns nothing.
  5480.  
  5481.                VIEWMSG <number> -
  5482.                Displays the  given message number, from the current message
  5483.                area.  Last read pointers are not updated.   Returns  a non-
  5484.                zero value upon failure.
  5485.  
  5486.                YELL -
  5487.                Flashes the screen 5 times and posts a message in the status
  5488.                window stating that the  online  user  has  paged.   Returns
  5489.                nothing and takes no parameters.
  5490.  
  5491.  
  5492.           Commands Recognized with no Caller Online:
  5493.  
  5494.                Here are  the commands  that TransAmiga  understands when it
  5495.                was started with  the  -r  option,  these  commands  are not
  5496.                recognized when there is a caller online:
  5497.  
  5498.                BAUDRATE <baud> -
  5499.  
  5500.  
  5501.  
  5502.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  5503.  
  5504.  
  5505.  
  5506.  
  5507.  
  5508.           TransAmiga BBS User Manual                                Page 87
  5509.  
  5510.  
  5511.                Specifies the baud rate the TransAmiga should log the caller
  5512.                on at.   Typically  this  is  followed  closely  by  a LOGON
  5513.                command.   Equivalent to  the -b command line parameter.  It
  5514.                will only actually change the baud  rate of  the serial port
  5515.                if the  LOCKBAUD or  -l options  were not  used.  It returns
  5516.                nothing.
  5517.  
  5518.                LOCAL [WAIT] -
  5519.                Does a local logon, equivalent to the Local  Logon item from
  5520.                the  pull-down  menu.    It  takes  no arguments and returns
  5521.                nothing.
  5522.  
  5523.                If the optional WAIT  keyword is  passed, this  command will
  5524.                not returned until the local user has logged off, otherwise,
  5525.                it will return immediately.
  5526.  
  5527.                LOCKBAUD <baud> -
  5528.                Specifies at what baudrate TransAmiga should lock the serial
  5529.                port at.   Equivalent  to the -l command line parameter.  It
  5530.                returns nothing.
  5531.  
  5532.                LOGON [WAIT] -
  5533.                Tells TransAmiga to log on  an  online  user.    Typically a
  5534.                combination of  BAUDRATE and  possibly LOCKPORT, MAXTIME and
  5535.                USERNAME commands are issued right before this.  It takes no
  5536.                arguments and returns nothing.
  5537.  
  5538.                If the  optional WAIT  keyword is  passed, this command will
  5539.                not return until the call has  completed, otherwise  it will
  5540.                return immediately.
  5541.  
  5542.                MAXTIME <minutes> -
  5543.                Specifies the  maximum amount  of time  the next caller will
  5544.                have.  Equivalent to the  -t  command  line  parameter.   It
  5545.                returns nothing.
  5546.  
  5547.                RESCAN -
  5548.                Tells TransAmiga to rescan the message areas.  You will need
  5549.                to do this if TrUMP has been run  because of  changes to the
  5550.                message pointers  (eg. after  a renumber  or import) without
  5551.                the BBS being restarted.  It takes no  arguments and returns
  5552.                nothing.
  5553.  
  5554.                QUIT -
  5555.                Simply tells  TransAmiga to shut down completely, equivalent
  5556.                to the Quit item from  the  pull-down  menu.    It  takes no
  5557.                arguments and returns nothing.
  5558.  
  5559.                UNLOCKPORT -
  5560.  
  5561.  
  5562.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  5563.  
  5564.  
  5565.  
  5566.  
  5567.  
  5568.           TransAmiga BBS User Manual                                Page 88
  5569.  
  5570.  
  5571.                Tells TransAmiga  not to lock the serial port, and to adjust
  5572.                the baud rate of the serial  port  to  that  of  the caller.
  5573.                This  is  the  default,  and  is  only  used  to over-ride a
  5574.                LOCKPORT or -l command.
  5575.  
  5576.                USERNAME <user> -
  5577.                This can be used to bypass the initial user name prompt once
  5578.                the LOGON  or LOCAL  command is executed.  The logon process
  5579.                will start with the BBS evaluating the name entered.  If the
  5580.                user  is  currently  a  member,  the password prompt will be
  5581.                entered.  If not,  the guest  user process  will take place.
  5582.                If its  an invalid  name, then the BBS will display the user
  5583.                prompt.
  5584.  
  5585.                This command is very useful with  frontends that  take input
  5586.                from the user (eg. Welmat).  This way you can get the user's
  5587.                name from the frontend and pass it directly to the BBS.
  5588.  
  5589.                The commands are typically  used  in  conjunction  with some
  5590.                kind of  frontend, such  as a  FidoNet mailer.   Using these
  5591.                commands, you can have the BBS in memory  all the  time, and
  5592.                have the  frontend run  an ARexx  macro to "wake-up" the BBS
  5593.                and save the  usual  waiting  period  while  the  BBS loads,
  5594.                making   the   transition   from   frontend  to  BBS  almost
  5595.                instantaneous for the caller.
  5596.  
  5597.  
  5598.           SkyLine/C-Net ARexx Emulation:
  5599.  
  5600.                TransAmiga also understands many  of  the  same  commands as
  5601.                SkyLine BBS  does.   Those of  you familiar with its command
  5602.                set will have noticed that  several  commands  are  the same
  5603.                (eg. GETCHAR  and QUERY), while other commands work are very
  5604.                similar to  SkyLine BBS  ARexx commands,  but have different
  5605.                names  (such  as  SYSOPLOG,  which is directly equivalent to
  5606.                SkyLine's LOGENTRY commands).  TransAmiga therefore provides
  5607.                synonyms  for  these  commands,  so  that most SkyLine ARexx
  5608.                macros can be run under TransAmiga  almost unmodified.   All
  5609.                that needs to be done is to remove the line:
  5610.  
  5611.                  address 'SkyLine'
  5612.  
  5613.                from  any   ARexx  macros,   and  they   should  work  under
  5614.                TransAmiga.  If they do not,  it is  because they  are using
  5615.                SkyLine ARexx commands that TransAmiga does not support.  If
  5616.                this happens, usually only very simple modifications will be
  5617.                necessary to support the equivalent TransAmiga commands.
  5618.  
  5619.  
  5620.  
  5621.  
  5622.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  5623.  
  5624.  
  5625.  
  5626.  
  5627.  
  5628.           TransAmiga BBS User Manual                                Page 89
  5629.  
  5630.  
  5631.                In  addition  to  TransAmiga's  commands  which  are already
  5632.                compatible  with  SkyLine,  TransAmiga  supports:  TRANSMIT,
  5633.                SENDSTRING,  LOGENTRY,  BUFFERFLUSH,  SHUTDOWN, CHECKIO, and
  5634.                some instances if the GETUSER command.
  5635.  
  5636.  
  5637.           Example ARexx Macro:
  5638.  
  5639.                To help you get  started writing  your own  ARexx macros for
  5640.                TransAmiga, a  very simple  example is  given here.  Its not
  5641.                particularly  useful  for   any   purpose   other   than  to
  5642.                illustrate  how  to  use  TransAmiga ARexx interface.  Lines
  5643.                have been numbered in  this manual  for easy  reference, but
  5644.                actual  ARexx   macros,  naturally,  would  not  have  these
  5645.                numbers.
  5646.  
  5647.            1: /* Example.trans - the World Famous Hi-Lo Game! */
  5648.  
  5649.            2: options results
  5650.  
  5651.            3: userinfo a ; username=result
  5652.  
  5653.            4: print "Welcome" username "to The World Famous Hi-Lo Game!"
  5654.            5: newline
  5655.  
  5656.            6: keepgoing=1
  5657.  
  5658.            7: do while keepgoing=1
  5659.            8:     num=random(1,100,time(e))
  5660.  
  5661.            9:     print "OK, I have chosen a number between 1 and 100, and"
  5662.           10:     print "it is your job to guess what it is."
  5663.  
  5664.           11:     notright=1
  5665.           12:     guesses=0
  5666.  
  5667.           13:     do while notright=1
  5668.           14:          guesses=guesses+1
  5669.           15:          prompt 3 'NORMAL' '"Enter guess #'guesses': "'
  5670.           16:          guess=result
  5671.           17:          if carrier=0 then exit 10
  5672.  
  5673.           18:          if guess<num then print "Too low."
  5674.           19:          if guess>num then print "Too high."
  5675.           20:          if guess=num then notright=0
  5676.           21:     end
  5677.  
  5678.           22:     print "You win!  And it only took you" guesses " tries!"
  5679.           23:     newline
  5680.  
  5681.  
  5682.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  5683.  
  5684.  
  5685.  
  5686.  
  5687.  
  5688.           TransAmiga BBS User Manual                                Page 90
  5689.  
  5690.  
  5691.  
  5692.           24:     prompt 1 'YESNO' '"Would you like to play again?"'
  5693.           25:     answ=result
  5694.           26:     if carrier=0 then exit 10
  5695.           27:     if answ='N' then keepgoing=0
  5696.           28: end
  5697.           29: print "Bye!"
  5698.  
  5699.           30: exit
  5700.  
  5701.                line 1:  This is  a comment  line, every  single ARexx macro
  5702.                must start  off with  a comment line like this.  Comments in
  5703.                ARexx are enclosed in /* and */
  5704.  
  5705.                line 2: All your  TransAmiga  ARexx  macros  must  have this
  5706.                line.   It tells  ARexx that it should expect the host (that
  5707.                is, the BBS) to set the result after a command.
  5708.  
  5709.                line 3: This  is  the  first  usage  of  a  TransAmiga ARexx
  5710.                command,  USERINFO.    USERINFO  takes as a parameter a code
  5711.                which tells it what piece of information to return.  In this
  5712.                case,  the  code  is  A,  which  means  it should return the
  5713.                current user's name.  Our ARexx macro takes  this value (all
  5714.                values  returned  by  TransAmiga  are stored in the variable
  5715.                result) and  copies into  a variable  called username (since
  5716.                the result variable will be changed by other commands).
  5717.  
  5718.                line 4,5:  These two lines make use of the PRINT and NEWLINE
  5719.                TransAmiga ARexx commands.   Note  in  line  4  how  you can
  5720.                easily  include  variables  in  the  arguments  you  pass to
  5721.                TransAmiga ARexx commands.
  5722.  
  5723.                line 6,7: This initiates the play  loop for  our game, using
  5724.                ARexx's DO WHILE... construct.
  5725.  
  5726.                line 8:  Makes use  of ARexx's built-in RANDOM() function to
  5727.                generate the number that the user is going to have to guess.
  5728.  
  5729.                line 9,10: Uses TransAmiga's PRINT command again to show the
  5730.                user some information.
  5731.  
  5732.                line  11,12,13:  Initiates  the  guessing  loop, again using
  5733.                ARexx's DO WHILE.. construct.
  5734.  
  5735.                line 14: Increments the guesses variable that we initialized
  5736.                earlier, to keep track of the number of guesses the user has
  5737.                made.
  5738.  
  5739.  
  5740.  
  5741.  
  5742.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  5743.  
  5744.  
  5745.  
  5746.  
  5747.  
  5748.           TransAmiga BBS User Manual                                Page 91
  5749.  
  5750.  
  5751.                line 15,16: Prompts the user for a guess  using TransAmiga's
  5752.                PROMPT command.   NORMAL  indicates the input type, and 3 is
  5753.                the maximum number of characters the  user can  enter (since
  5754.                the  number  is  between  1  and  100,  there's  no point in
  5755.                entering anything longer than 3 characters).   The  text the
  5756.                user entered is then copied into the variable guess.
  5757.  
  5758.                line 17: This is a very important line.  While our macro was
  5759.                waiting for input, the user could have dropped  carrier, had
  5760.                the idle  timer expire,  or had  his/her time limit run out.
  5761.                In which case, it would be pointless and stupid for our game
  5762.                to continue  without a  user there to play.  What we do then
  5763.                is check the TransAmiga variable CARRIER  to see  whether or
  5764.                not the  user is  still there.   If  it's 0,  then he/she is
  5765.                gone, so our macro should exit.  Otherwise, we can continue.
  5766.  
  5767.                line 18,19,20: Here we check the user's guess  to see  if it
  5768.                is too  high or  too and  tell the  user so.   If the user's
  5769.                guess is correct, we exit the guessing loop.
  5770.  
  5771.                line 21: The end  of the  guessing loop,  go back  up to the
  5772.                beginning of this loop.
  5773.  
  5774.                line 22,23:  Congratulate the  user using TransAmiga's PRINT
  5775.                and NEWLINE commands.
  5776.  
  5777.                line 24,25: Ask the user if he/she would like to play again.
  5778.                This uses  TransAmiga's PROMPT  command again, but this time
  5779.                we use the YESNO input  type,  since  we  want  the  user to
  5780.                answer Yes  or No.  The user's response (which is guaranteed
  5781.                to be either Y or N) is copied into the variable answ.
  5782.  
  5783.                line 26: Once again,  the all  important check  to make sure
  5784.                the user is still with us.
  5785.  
  5786.                line  27:  If  the  user  responded  with  No, then exit the
  5787.                playing loop.
  5788.  
  5789.                line 28: End of the playing loop, go back to the start.
  5790.  
  5791.                line 29: Say good-bye!
  5792.  
  5793.                line 30: Exit, end of our macro.
  5794.  
  5795.                Any actual macro you were  to  write  would  naturally  be a
  5796.                little more  involved that  this.  For example, you may want
  5797.                to display ANSI graphics to users that have  ANSI turned on.
  5798.                Also,  a  little  more  "idiot-proofing" should be done (for
  5799.                example, if the user  enters text  instead of  a number, the
  5800.  
  5801.  
  5802.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  5803.  
  5804.  
  5805.  
  5806.  
  5807.  
  5808.           TransAmiga BBS User Manual                                Page 92
  5809.  
  5810.  
  5811.                macro will  halt with  an error).  However, this should give
  5812.                you a good idea of what a TransAmiga ARexx macro  looks like
  5813.                and you should be ready now to write some of your own.
  5814.  
  5815.  
  5816.  
  5817.  
  5818.  
  5819.  
  5820.  
  5821.  
  5822.  
  5823.  
  5824.  
  5825.  
  5826.  
  5827.  
  5828.  
  5829.  
  5830.  
  5831.  
  5832.  
  5833.  
  5834.  
  5835.  
  5836.  
  5837.  
  5838.  
  5839.  
  5840.  
  5841.  
  5842.  
  5843.  
  5844.  
  5845.  
  5846.  
  5847.  
  5848.  
  5849.  
  5850.  
  5851.  
  5852.  
  5853.  
  5854.  
  5855.  
  5856.  
  5857.  
  5858.  
  5859.  
  5860.  
  5861.  
  5862.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  5863.  
  5864.  
  5865.  
  5866.  
  5867.  
  5868.           TransAmiga BBS User Manual                                Page 93
  5869.  
  5870.  
  5871.  
  5872.  
  5873.                                    P A R T  V I I
  5874.                                    --------------
  5875.  
  5876.  
  5877.  
  5878.  
  5879.  
  5880.                                       Politics
  5881.  
  5882.  
  5883.           Disclaimer:
  5884.  
  5885.                No warranties  are implied  or expressed  with regard to the
  5886.                fitness  or  merchantability  of  TransAmiga  BBS   for  any
  5887.                particular purposes.   All  risks and damages, incidental or
  5888.                otherwise, arising through the  use or  misuse of TransAmiga
  5889.                BBS are entirely at the responsibility of the user.
  5890.  
  5891.                While considerable  effort has been made to provide you with
  5892.                a  reliable  product,  there   is  no   guarantee  that  the
  5893.                programmes are  100% "bug-free".   Any bugs will be fixed at
  5894.                the  author's  discretion  in  possible  future  releases of
  5895.                TransAmiga BBS.
  5896.  
  5897.  
  5898.           License:
  5899.  
  5900.                "TransAmiga"  refers  to  a  set  of  programmes  for  Amiga
  5901.                computers by Timothy J. Aston making  up the  TransAmiga BBS
  5902.                package.
  5903.  
  5904.                1.  TransAmiga  is  the  copyrighted  material of Timothy J.
  5905.                Aston.    It  may  only  be  used  in  accordance  with  the
  5906.                conditions set out by this license agreement.
  5907.  
  5908.                2.   So that  you may evaluate TransAmiga, you are granted a
  5909.                limited use license for a period  of twenty  (20) days after
  5910.                initial usage.  After this period you must register with the
  5911.                author or discontinue using TransAmiga.
  5912.  
  5913.                3. Registration  entitles  you  to  use  TransAmiga  and any
  5914.                future versions  of TransAmiga  as long as you wish, subject
  5915.                to  any  special  licensing  conditions  attached  to future
  5916.                versions.
  5917.  
  5918.                4. Timothy  J. Aston  is in no way obliged to provide future
  5919.                versions or support for TransAmiga.
  5920.  
  5921.  
  5922.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  5923.  
  5924.  
  5925.  
  5926.  
  5927.  
  5928.           TransAmiga BBS User Manual                                Page 94
  5929.  
  5930.  
  5931.  
  5932.                5. You may not modify, disassemble,  decompile, re-source or
  5933.                otherwise reverse engineer TransAmiga.
  5934.  
  5935.                6. Distribution is limited to the original shareware archive
  5936.                file only, none of the member  files may  be omitted  and no
  5937.                new  additional  files  may  be  included.   Furthermore, no
  5938.                profit  or   other  material   gain  may   be  realized  for
  5939.                distributing  TransAmiga  with  the  sole  exception of that
  5940.                which is required to cover the cost of the medium.  Bundling
  5941.                TransAmiga, the  distribution archive,  or any member files,
  5942.                with any commercial product  is  not  permitted  without the
  5943.                express written  consent of  the author.  At no time are you
  5944.                permitted to distribute or modify the file "TransAmiga.Key".
  5945.  
  5946.                7. TransAmiga  may not  be used  in any  unlawful or illegal
  5947.                manner.
  5948.  
  5949.  
  5950.  
  5951.  
  5952.  
  5953.  
  5954.  
  5955.  
  5956.  
  5957.  
  5958.  
  5959.  
  5960.  
  5961.  
  5962.  
  5963.  
  5964.  
  5965.  
  5966.  
  5967.  
  5968.  
  5969.  
  5970.  
  5971.  
  5972.  
  5973.  
  5974.  
  5975.  
  5976.  
  5977.  
  5978.  
  5979.  
  5980.  
  5981.  
  5982.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  5983.  
  5984.  
  5985.  
  5986.  
  5987.  
  5988.           TransAmiga BBS User Manual                                Page 95
  5989.  
  5990.  
  5991.                                     Registration
  5992.  
  5993.  
  5994.           Shareware:
  5995.  
  5996.                TransAmiga  is  distributed  under the concept of shareware.
  5997.                Some people like to call this particular brand  of shareware
  5998.                "crippleware"  because  I  am  distributing  a  version with
  5999.                several  features  removed.    It's  not  "crippled" though,
  6000.                because enough  features are  enabled for  you to set up the
  6001.                BBS, use it, and decide what you think about it.
  6002.  
  6003.                This allows you to "try before you buy."  If, after a period
  6004.                of 20  days you  decide that TransAmiga is not the thing for
  6005.                you, simply delete it  and all  it's files,  and no  harm is
  6006.                done.   However, if  you decide  that you want to keep using
  6007.                it, you simply  register  yourself,  and  you  get  your own
  6008.                keyfile making the BBS fully functional.
  6009.  
  6010.  
  6011.           How to Register:
  6012.  
  6013.                To register, you must follow these instructions.
  6014.  
  6015.                The registration fee should be in the form of cash, a postal
  6016.                money order, or any cheque or money order that is negotiable
  6017.                at a Canadian chartered bank.  Most cheques and money orders
  6018.                drawn on major world  currencies  are  acceptable,  but only
  6019.                cash in  Canadian dollars,  U.S. dollars and U.K. pounds can
  6020.                be accepted (it is  generally  not  advisable  to  send cash
  6021.                through the  mail anyway).   Please  make cheques payable to
  6022.                "Timothy Aston".  These are  the  only  possible  methods of
  6023.                payment for  registration.   International bank transfers to
  6024.                my account would be very slow and costly, plus I never quite
  6025.                know when  the money  has actually arrived, so do not bother
  6026.                with that.  If you are sending an international postal money
  6027.                order,  please  remember  that  you  must  also send a cover
  6028.                letter.
  6029.  
  6030.                The registration fees are as follows:
  6031.  
  6032.                Canada -
  6033.                thirty dollars ($30) Canadian funds
  6034.  
  6035.                United States -
  6036.                thirty dollars ($30) U.S. funds
  6037.  
  6038.                Elsewhere -
  6039.                thirty-five dollars ($35) U.S. funds
  6040.  
  6041.  
  6042.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  6043.  
  6044.  
  6045.  
  6046.  
  6047.  
  6048.           TransAmiga BBS User Manual                                Page 96
  6049.  
  6050.  
  6051.  
  6052.                This amount covers the registration fee, as well  as postage
  6053.                and media costs.
  6054.  
  6055.                You should send the money along with a letter (note: even if
  6056.                you send an international postal money order, you  must also
  6057.                send a letter) which clearly gives following information:
  6058.  
  6059.                 * Your full name
  6060.                 * Your complete mailing address
  6061.                 * Your voice Telephone number
  6062.                 * Some  details about  the BBS you run, including the phone
  6063.                number(s), hours of operation, baud rates supported, etc.
  6064.                 * Your network addresses for FidoNet and any other networks
  6065.                you  may  be  a  member  of  (please specify the name of the
  6066.                networks).
  6067.  
  6068.                Additionally,  you  may  include   any   of   the  following
  6069.                information,  which  I  just  like  to  know out of personal
  6070.                interest.  They are all optional:
  6071.  
  6072.                 * What kind of Amiga(s) you own, and what hardware you have
  6073.                for them.
  6074.                 *  How  long  you've  been  a SysOp for, and what other BBS
  6075.                software you have used.
  6076.                 * What you like the most and the least about TransAmiga.
  6077.                 * What  your  occupation  is,  your  hobbies,  favourite TV
  6078.                shows, preferred sports teams, etc.
  6079.                 *  Any   other  interesting  facts  about  yourself  (world
  6080.                records, appearances on popular TV game shows, etc).
  6081.  
  6082.                All this should be sent to:
  6083.  
  6084.                  TransAmiga Registration
  6085.                  c/o Timothy Aston
  6086.                  128 Riverview Blvd.
  6087.                  St. Catharines, Ont.
  6088.                  L2T 3M2
  6089.                  CANADA
  6090.  
  6091.                In return,  you will  be sent  a floppy  disk containing the
  6092.                latest  version  of  TransAmiga  BBS,  along  with  your own
  6093.                personalized  keyfile   to   enable   TransAmiga's  crippled
  6094.                features.   All disks are sent via Canada post regular mail,
  6095.                please allow 3-6 weeks for delivery.
  6096.  
  6097.                Registration through the author  is  the  only  way  you can
  6098.                become a registered TransAmiga users.
  6099.  
  6100.  
  6101.  
  6102.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  6103.  
  6104.  
  6105.  
  6106.  
  6107.  
  6108.           TransAmiga BBS User Manual                                Page 97
  6109.  
  6110.  
  6111.  
  6112.           Support:
  6113.  
  6114.                As a  registered user,  you will be entitled to support from
  6115.                the author from the following sources:
  6116.  
  6117.                 * FidoNet netmail:
  6118.                     Tim Aston @ 1:247/192.0 (*)
  6119.                 * UUCP E-Mail through the FidoNet gateway:
  6120.                     tim.aston@p0.f192.n247.z1.fidonet.org
  6121.                 * FAX:
  6122.                     +1-416-682-3501
  6123.                 * Chris's Amiga BBS,  +1-716-289-3351, DS-HST, 1:260/660.0,
  6124.                SysOp Christopher  Kloiber, in Manchester, New York, U.S.A.-
  6125.                official distribution and support HQ or TransAmiga BBS.
  6126.                 *  DecBBS,  +353-1-288-2454,  DS-HST,   2:263/198.0,  SysOp
  6127.                Declan  McArdle,  in  Dublin,  Ireland  -  official European
  6128.                distribution site and support board.
  6129.                 * Amiga Time, +1-315-454-3072, HST, 1:2608/22.0, SysOp John
  6130.                Kratz, in  Mattydale, New  York, U.S.A.  - official American
  6131.                support board for TransAmiga BBS.
  6132.                 * MEBBS ][, +1-306-775-1437, 2400 Baud,  1:140/140.0, SysOp
  6133.                Jim  MacKenzie,  in  Regina, Saskatchewan, Canada - official
  6134.                Canadian support board for TransAmiga BBS.
  6135.                 * Essex Amiga BBS,  +44-277-233354, HST,  2:440/67.0, SysOp
  6136.                Mark Kidd, in Brentwood, Essex, U.K. - official U.K. support
  6137.                board for TransAmiga BBS.
  6138.                 * Amiga on Phone BBS, +49-7271-6877,  DS-HST, 2:241/7520.0,
  6139.                SysOp  Sami  Radwan,  in  Woerth,  Germany - official German
  6140.                support board for TransAmiga BBS.
  6141.                 * Regular mail (remember that?):
  6142.                     Timothy Aston
  6143.                     128 Riverview Blvd.
  6144.                     St. Catharines, Ont.
  6145.                     L2T 3M2
  6146.                     CANADA
  6147.  
  6148.                Please, do not call me at home, I have a  life you  know.  I
  6149.                tend to be quite busy, and I'm just not setup to spend a lot
  6150.                of time on the phone with users (besides, I'm not home often
  6151.                anyway).
  6152.  
  6153.                A  dedicated  support  echo  called  TRANSAMIGA  also exists
  6154.                available on several regional backbones.   If your  REC does
  6155.                               
  6156.  
  6157.                * The telephone  number of this address is unpublished.  For
  6158.           the quickest mail deliver, route mail through 1:247/205.
  6159.  
  6160.  
  6161.  
  6162.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  6163.  
  6164.  
  6165.  
  6166.  
  6167.  
  6168.           TransAmiga BBS User Manual                                Page 98
  6169.  
  6170.  
  6171.                not carry it, please tell him/her that you'd like to  see it
  6172.                on your  region's backbone, and in the meantime you can link
  6173.                up through Chris' Amiga BBS, or any other site carrying it.
  6174.  
  6175.                TransAmiga may be periodically upgraded.   All upgrades will
  6176.                be made  available on  the support  boards and  on the Amiga
  6177.                Distribution  System's  (ADS)  dedicated   TransAmiga  area,
  6178.                ADSTRANS.   Since registered and unregistered users actually
  6179.                use the same programme, there is no need  to mail registered
  6180.                users upgrades.   New  versions will  recognize your keyfile
  6181.                and run in registered mode.
  6182.  
  6183.  
  6184.  
  6185.  
  6186.  
  6187.  
  6188.  
  6189.  
  6190.  
  6191.  
  6192.  
  6193.  
  6194.  
  6195.  
  6196.  
  6197.  
  6198.  
  6199.  
  6200.  
  6201.  
  6202.  
  6203.  
  6204.  
  6205.  
  6206.  
  6207.  
  6208.  
  6209.  
  6210.  
  6211.  
  6212.  
  6213.  
  6214.  
  6215.  
  6216.  
  6217.  
  6218.  
  6219.  
  6220.  
  6221.  
  6222.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  6223.  
  6224.  
  6225.  
  6226.  
  6227.  
  6228.           TransAmiga BBS User Manual                                Page 99
  6229.  
  6230.  
  6231.                                      Conclusion:
  6232.  
  6233.  
  6234.           Future:
  6235.  
  6236.                Here's some things I'm  planning to  add in  the (hopefully)
  6237.                not too distant future:
  6238.  
  6239.                 *    Redesigned    user    interface   according   to   the
  6240.                recommendations set out by Commodore's style guide.
  6241.                 * A  set of  Release 2  style Preferences  tools to replace
  6242.                TransCfg.
  6243.                 *  A  completely  open-ended  menu design system, that will
  6244.                give you complete flexibility in customizing your menus.
  6245.                 *  Full  support  for  a  standard   message  base  library
  6246.                currently being developed.
  6247.                 * Greater flexibility, more commands, etc., etc.
  6248.  
  6249.                NOTE: Apart from possible minor upgrades to TransAmiga v1.1,
  6250.                all versions past v1.1  will probably  require Release  2 of
  6251.                the Amiga's operating system.
  6252.  
  6253.  
  6254.           Comments:
  6255.  
  6256.                If  you  have  anything  you  would  like  to  tell me about
  6257.                TransAmiga, I encourage you to speak.  Comments, criticisms,
  6258.                suggestions, praise,  bug reports,  and the  time of day are
  6259.                all very welcome.  I really like to receive comments.
  6260.  
  6261.  
  6262.           Acknowledgements:
  6263.  
  6264.                Special thanks  to  the  following  people  (in  no specific
  6265.                order):
  6266.  
  6267.                 * Ryan Lanyon, my first beta-tester.
  6268.                 * Christopher  Kloiber, my  secondary beta-tester and SysOp
  6269.                of the North American support board, who does an outstanding
  6270.                job at  reporting the  bugs, making suggestions, and helping
  6271.                out other TransAmiga SysOps.
  6272.                 * The other support board SysOps: Declan McArdle, Mark Kidd
  6273.                and Jim MacKenzie.
  6274.                 * Declan  McArdle, for TrBroad, and for his tremendous help
  6275.                in distributing TransAmiga files  and  information  all over
  6276.                Europe.
  6277.                 * Steve Palm for the TransAmiga support in ConfMail.
  6278.                 * Peer  Hasselmeyer for allowing me to be a beta-tester for
  6279.                Foozle, the absolute best FidoNet mail system for the Amiga.
  6280.  
  6281.  
  6282.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  6283.  
  6284.  
  6285.  
  6286.  
  6287.  
  6288.           TransAmiga BBS User Manual                                Page 100
  6289.  
  6290.  
  6291.                 * The makers of HiSoft BASIC,  the only  BASIC compiler for
  6292.                the Amiga worth half a hill of beans.
  6293.                 *  Bruce  Geerdes  for  writing  Petra, a fine example of a
  6294.                BASIC BBS.
  6295.                 * Maximilian Hantsch for writing TrapDoor, and for the free
  6296.                registered version.
  6297.                 *  Michael  Richardson  and  Russell  McOrmand  for writing
  6298.                Welmat, and for making it free.
  6299.                 *  Damian  Rogers  for  helping  with  writing  the FidoNet
  6300.                documentation.
  6301.                 *  Jonathan  Forbes  and  Steve  Tibbett  for  their  work,
  6302.                patience and co-operation in creating the ABBEREXX standard.
  6303.                 * My parents for paying my phone bills.
  6304.                 * All the users that made suggestions, offered bug reports,
  6305.                and other helpful things.
  6306.                 *  My  competition,  for  pushing  me to add new and better
  6307.                features.
  6308.                 * All the people that have registered TransAmiga.   I never
  6309.                dreamed it would ever get this big in such a short amount of
  6310.                time.
  6311.  
  6312.  
  6313.           On Your Own:
  6314.  
  6315.                That about wraps things up, you're on your own from  now on.
  6316.                I  apologize  if  I  forgot  to  mention  anything  in  this
  6317.                documentation, if I was a little  vague at  times, or  if my
  6318.                grammar was  not perfect  (spelling wasn't bad though thanks
  6319.                to WordPerfect).   If  you  think  you  can  write something
  6320.                better, I  encourage it.   I hope you enjoy using TransAmiga
  6321.                and I look forward to hearing your comments!
  6322.  
  6323.  
  6324.                -Tim
  6325.  
  6326.  
  6327.  
  6328.  
  6329.  
  6330.  
  6331.  
  6332.  
  6333.  
  6334.  
  6335.  
  6336.  
  6337.  
  6338.  
  6339.  
  6340.  
  6341.  
  6342.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  6343.  
  6344.  
  6345.  
  6346.  
  6347.  
  6348.           TransAmiga BBS User Manual                                Page 101
  6349.  
  6350.  
  6351.  
  6352.  
  6353.  
  6354.                                  A P P E N D I C E S
  6355.                                  -------------------
  6356.  
  6357.  
  6358.  
  6359.  
  6360.                                      Appendix I
  6361.  
  6362.  
  6363.           Samples:
  6364.  
  6365.                This appendix provides numerous  samples  for  to  follow to
  6366.                help you  in getting your system running.  The samples cover
  6367.                a wide range of applications,  and  you  will  probably only
  6368.                need to  refer to  a few  of them  depending on how you have
  6369.                things set up.   Be careful,  as some  lines have  had to be
  6370.                wrapped so as to fit in the manual.
  6371.  
  6372.  
  6373.           Sample TrapDoor Configuration:
  6374.  
  6375.                This  is  an  example  configuration  file  for the TrapDoor
  6376.                FidoNet mailer, running as a node.
  6377.  
  6378.                In addition to the  TrapDoor programme  itself, the TrapDoor
  6379.                package comes  with three  other programmes you will be need
  6380.                in your  setup, TrapTell,  TrapPoll and  TrapList.  TrapTell
  6381.                won't be  used in  our examples,  but TrapPoll will, and you
  6382.                will need TrapList, as  that is  TrapDoor's special nodelist
  6383.                processor.    Copy  all  of  the files into Mail:.  TrapDoor
  6384.                comes with a shared  library called  traplist.library, which
  6385.                must be  placed in  your Libs:  directory.  There are also a
  6386.                few other tools that come with  TrapDoor which  you may find
  6387.                useful, but will not be explained here.
  6388.  
  6389.                Here is  a sample  configuration file.   Comment lines start
  6390.                with a semi-colon (;).
  6391.  
  6392.                ; This is your node number.  If you haven't yet received
  6393.                ; yours, use zone:net/9999.o
  6394.                NODE 1:247/9999.0
  6395.                ; This is the name you've chosen for your system
  6396.                NAME "TransAmiga Development"
  6397.                ; This should be easy enough, your name
  6398.                SYSOP "Tim Aston"
  6399.                ; When you are going to perform password protected session,
  6400.  
  6401.  
  6402.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  6403.  
  6404.  
  6405.  
  6406.  
  6407.  
  6408.           TransAmiga BBS User Manual                                Page 102
  6409.  
  6410.  
  6411.                ; this is where the password goes.  For now, leave at ""
  6412.                PASSWORD ""
  6413.                ; Your maximum and minimum baud rate.  Unless you're using
  6414.                ; an HST, leave NOLOCK as is.
  6415.                BAUD 2400 NOLOCK MINBAUD 300
  6416.                ; The address and phone number of your mail feed.
  6417.                BOSS 1:247/9999.0
  6418.                CALL 1:247/99
  6419.                ; These parameters define the type of mail sessions TrapDoor
  6420.                ; will do.  Generally you don't have to alter them.
  6421.                DIETIFNA ZEDZAP
  6422.                WAZOO
  6423.                ; Your Outbound, Inbound, and Nodelist directories.  If you
  6424.                ; don't have a nodelist, use NODELIST ""
  6425.                OUTBOUND "Mail:Outbound"
  6426.                INBOUND "Mail:Inbound"
  6427.                NODELIST "NodeList:"
  6428.                MAXBAUD
  6429.                RINGS 1
  6430.                ; Some BBS setup commands, leave these as is for now
  6431.                BANNER "This is my BBS running TransAmiga"
  6432.                ; The BBS startup command
  6433.                BBSCOMMAND "rx StartBBS %b"
  6434.                BBSINOUT ""
  6435.                BBSMODE SPAWN
  6436.                ; Log file setup
  6437.                LOGFILE "ram:TrapDoor.log"
  6438.                LOGLEVEL 0:2
  6439.                LOGLEVEL 1:2
  6440.                LOGLEVEL 2:2
  6441.                LOGLEVEL 3:2
  6442.                LOGLEVEL 4:2
  6443.                LOGLEVEL 5:2
  6444.                LOGLEVEL 6:7
  6445.                LOGLEVEL 7:2
  6446.                LOGLEVEL 8:5
  6447.                LOGLEVEL 9:2
  6448.                WRAPLINES
  6449.                SLOWMODEM 10
  6450.                ; Your modem commands.  On a typical 1200 or 2400 baud modem
  6451.                ; these should be enough
  6452.                MODEMINIT "ATZ|~~~~~"
  6453.                MODEMHANGUP "||^|"
  6454.                MODEMDIALPRE "ATDT "
  6455.                MODEMDIALPORT "|"
  6456.                MODEMANSWER "ATA|"
  6457.                SHARED
  6458.                ; If you've got ARexx, you can use the FRequest.rexx macro
  6459.                ; to allow other FidoNet systems to request files from you.
  6460.  
  6461.  
  6462.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  6463.  
  6464.  
  6465.  
  6466.  
  6467.  
  6468.           TransAmiga BBS User Manual                                Page 103
  6469.  
  6470.  
  6471.                ; If you don't have ARexx, change this to FREQUEST ""
  6472.                FREQUEST "rx FRequest %i,%o,%l"
  6473.                ; Import.rexx should be an ARexx script that does your
  6474.                ; importing and renumbering
  6475.                AFTERSESSION "rx Import"
  6476.                REXXNAME "TrapDoor"
  6477.                SHOWREXX
  6478.                DSR
  6479.                SERIALNAME "serial.device" SERIALUNIT 0 SERIALFLAGS 0
  6480.                ADJUST -11
  6481.                LOGWINDOW 30/12/580/125 STATWINDOW 30/139/580/61
  6482.                SCREENMODE TRAPDOOR
  6483.                NOBACKGROUND AUTOOVERSCAN
  6484.                COLOURS $a00/$fff/$000/$99e
  6485.                ACCOUNTING ACTMAX "3000 20 2 20 5 2"
  6486.                ANSWER
  6487.                RETRIES 1 REDIALDELAY 1
  6488.                NOQUIET NOSWEPULSE
  6489.                FKEY "1:EMSI"
  6490.                FKEY "11:NOEMSI"
  6491.                FKEY "2:WAZOO"
  6492.                FKEY "12:NOWAZOO"
  6493.                FKEY "3:ZEDZAP"
  6494.                FKEY "13:NOZEDZAP"
  6495.                FKEY "4:DIETIFNA"
  6496.                FKEY "14:NODIETINFA"
  6497.                FKEY "5:BBSMODE SPAWN"
  6498.                FKEY "15:BBSMODE ZMH"
  6499.                FKEY "10:SPAWN \"TransAmiga -x\""
  6500.  
  6501.                Save your configuration in Mail: as TrapDoor.Cfg.   To start
  6502.                TrapDoor, you would just enter:
  6503.  
  6504.                  run TrapDoor
  6505.  
  6506.  
  6507.           Sample Welmat Configuration:
  6508.  
  6509.                This  is  an  example  configuration  for the Welmat FidoNet
  6510.                frontend mailer, running as a node.
  6511.  
  6512.                Welmat is  a  little  different  than  TrapDoor  in  that it
  6513.                requires a  few more  utilities to run.  There is the Welmat
  6514.                programme itself, WCompile, WCtl, WAbort, and  WGetLine.  In
  6515.                addition,   you   will   IGen   by   Todd   Kover   and  its
  6516.                nodelist.library for processing your  nodelist.    All these
  6517.                programmes should  go in  Mail:, except for nodelist.library
  6518.                and flow.library which should go into your Libs: directory.
  6519.  
  6520.  
  6521.  
  6522.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  6523.  
  6524.  
  6525.  
  6526.  
  6527.  
  6528.           TransAmiga BBS User Manual                                Page 104
  6529.  
  6530.  
  6531.                Lines starting with a # are comment lines.
  6532.  
  6533.                # You enter your address here, use zone:net/9999.0 if you
  6534.                # haven't received one yet
  6535.                Host           1:247/9999
  6536.                # Simple enough, your name
  6537.                Sysop          "Tim Aston"
  6538.                # This is the name you've chosen for your system
  6539.                System         "TransAmiga Development"
  6540.                # Log file information
  6541.                LogFile        ram:Welmat.Log
  6542.                LogFileLevel   30
  6543.                LogWindow      "WelMat Log" 0 119 333 81
  6544.                LogWindowName  "WelMat Log"
  6545.                DisplayLogLevel 30
  6546.                DisplayLogLevel 30
  6547.                StatusLevel     80
  6548.                # Your Outbound, Inbound, and Nodelist directories.  If you
  6549.                # don't have a nodelist, comment out that line
  6550.                FidoListM      NodeList:NODELIST
  6551.                Inbound        Mail:Inbound
  6552.                Outbound       Mail:OutBound
  6553.                # Codes is a file that comes with Welmat so that it can
  6554.                # identify what kind of system it is talking to
  6555.                CodeList       Mail:Codes
  6556.                # Here's where we set up the individual modem lines.  This,
  6557.                # of course, will be a single line setup, but we will
  6558.                # actually need TWO Modem # entries, one for normal BBS
  6559.                # spawning, and one for no BBS spawning.
  6560.                Modem 0
  6561.                     # Serial port and modem setup
  6562.                     Device    serial.device
  6563.                     Unit      0
  6564.                     ModemName "Avatex 2400E"
  6565.                     BaudRate  2400
  6566.                     # The modem commands.  These should work pretty much
  6567.                     # unchanged with most 1200 or 2400 baud modems.
  6568.                     Init      ~ATZ|~~
  6569.                     Dial      ~ATDT
  6570.                     Hangup    v~~^~~ATH0|~AT|
  6571.                     PostDial  ~~|~~
  6572.                     Atten     |~AT|
  6573.                     Answer    ATA|
  6574.                     # These are the modem response codes.  Again, these
  6575.                     # shouldn't have to be changed.
  6576.                     Response  busy "BUSY"
  6577.                     Response  ring "RING"
  6578.                     Response  maid "NO CARRIER"
  6579.                     Response  maid "ERROR"
  6580.  
  6581.  
  6582.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  6583.  
  6584.  
  6585.  
  6586.  
  6587.  
  6588.           TransAmiga BBS User Manual                                Page 105
  6589.  
  6590.  
  6591.                     Response  maid "VOICE"
  6592.                     Response  line "NO DIALTONE"
  6593.                     Response  300  "\r\nCONNECT\r\n"
  6594.                     Response  find "CONNECT %d"
  6595.                     Prompt    OK
  6596.                     # Some miscellaneous modem settings
  6597.                     ResponseWait   10
  6598.                     ConnectWait    60
  6599.                     UseDTR
  6600.                     No7Wire
  6601.                     # The command users see when they connect
  6602.                     WelcomeMessage "|Press Escape for my TransAmiga BBS|"
  6603.                     # This is the BBS startup command, we'll go into more
  6604.                     # detail about this later
  6605.                     BBSExecute "TransAmiga -b%d -x"
  6606.                     YesBBS
  6607.                     NoLogin
  6608.                     NoWaZoo
  6609.                     Launch
  6610.                     ReceiveCalls
  6611.                     StatusWindow   "RAW:316/159/324/41/Welmat Slave Status"
  6612.                     LogWindow      "WelMat Slave Log" 316 21 324 148
  6613.                ModemEnd
  6614.                # This is the ZMH configuration that doesn't spawn the BBS.
  6615.                # The Launch keyword is left out because we don't want
  6616.                # Welmat to start with this entry
  6617.                Modem 1
  6618.                     # Serial port and modem setup
  6619.                     Device    serial.device
  6620.                     Unit      0
  6621.                     ModemName "Avatex 2400E"
  6622.                     BaudRate  2400
  6623.                     # The modem commands.  These should work pretty much
  6624.                     # unchanged with most 1200 or 2400 baud modems.
  6625.                     Init      ~ATZ|~~
  6626.                     Dial      ~ATDT
  6627.                     Hangup    v~~^~~ATH0|~AT|
  6628.                     PostDial  ~~|~~
  6629.                     Atten     |~AT|
  6630.                     Answer    ATA|
  6631.                     # These are the modem response codes.  Again, these
  6632.                     # shouldn't have to be changed.
  6633.                     Response  busy "BUSY"
  6634.                     Response  ring "RING"
  6635.                     Response  maid "NO CARRIER"
  6636.                     Response  maid "ERROR"
  6637.                     Response  maid "VOICE"
  6638.                     Response  line "NO DIALTONE"
  6639.                     Response  300  "\r\nCONNECT\r\n"
  6640.  
  6641.  
  6642.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  6643.  
  6644.  
  6645.  
  6646.  
  6647.  
  6648.           TransAmiga BBS User Manual                                Page 106
  6649.  
  6650.  
  6651.                     Response  find "CONNECT %d"
  6652.                     Prompt    OK
  6653.                     # Some miscellaneous modem settings
  6654.                     ResponseWait   10
  6655.                     ConnectWait    60
  6656.                     UseDTR
  6657.                     No7Wire
  6658.                     # The command users see when they connect
  6659.                     WelcomeMessage "|Press Escape for my TransAmiga BBS|"
  6660.                     # This is the BBS startup command, we'll go into more
  6661.                     # detail about this later
  6662.                     NoBBS
  6663.                     NoLogin
  6664.                     NoWaZoo
  6665.                     ReceiveCalls
  6666.                     StatusWindow   "RAW:316/159/324/41/Welmat Slave Status"
  6667.                     LogWindow      "WelMat Slave Log" 316 21 324 148
  6668.                ModemEnd
  6669.  
  6670.                Save this file in  Mail:  as  Welmat.Cfg.    Welmat  works a
  6671.                little  differently  than  other  programmes, in that before
  6672.                Welmat can  understand  your  configuration  file,  you must
  6673.                compile it.   You  do this using the supplied WCompile tool,
  6674.                which will create a file called Welmat.Data which Welmat can
  6675.                read.
  6676.  
  6677.                To run Welmat you just need to type:
  6678.  
  6679.                  run Welmat
  6680.  
  6681.                You'd probably  want to do this somewhere in your s:Startup-
  6682.                Sequence.
  6683.  
  6684.  
  6685.           Sample ConfMail Configuration:
  6686.  
  6687.                ConfMail requires two configuration files, both go in Mail:.
  6688.                The first  is called Areas.BBS and that gives information on
  6689.                the various mail areas you wish to keep around.   The second
  6690.                is   called   Config.Dog,   and   that  contains  additional
  6691.                information for ConfMail.
  6692.  
  6693.                Here is a sample Areas.BBS file, lines starting with a ; are
  6694.                comment lines:
  6695.  
  6696.                ; The first line that is not a comment or blank must be the
  6697.                ; name of your system, following by a !, followed by your
  6698.                ; name.
  6699.  
  6700.  
  6701.  
  6702.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  6703.  
  6704.  
  6705.  
  6706.  
  6707.  
  6708.           TransAmiga BBS User Manual                                Page 107
  6709.  
  6710.  
  6711.                ;---  board name should not be longer than this  ---:
  6712.  
  6713.                TransAmiga Development ! Tim Aston
  6714.  
  6715.                ; Now come your areas.  First comes the directory, then
  6716.                ; the exact tag name for the echo, then the list of nodes
  6717.                ; that it gets exported to (usually only your mail feed).
  6718.  
  6719.                ; System areas, these two are required
  6720.                Mail:Netmail/               MAIL_DIR       247/99
  6721.                Mail:Bad/                   BAD_MSGS
  6722.  
  6723.                ; Echomail areas
  6724.                Mail:Echoes/Amiga_Net_Dev/  AMIGA_NET_DEV  247/99
  6725.                Mail:Echoes/Amiga_Prog/     AMIGA_PROG     247/99
  6726.                Mail:Echoes/Amiga_SysOp/    AMIGA_SYSOP    247/99
  6727.                Mail:Echoes/Amy_Point/      AMY_POINT      247/99
  6728.                Mail:Echoes/Niagara/        NIAGARA        247/99
  6729.                Mail:Echoes/TransAmiga/     TRANSAMIGA     247/99
  6730.                Mail:Echoes/TrapDoor/       TRAPDOOR       247/99
  6731.                Mail:Echoes/Welmat/         WELMAT         247/99
  6732.  
  6733.                Here is a sample Config.Dog file:
  6734.  
  6735.                ; This is your address
  6736.                NODE 1:247/9999
  6737.  
  6738.                ; Here you put the name of your outbound directory
  6739.                MAIL Mail:Outbound
  6740.  
  6741.                ; This is you inbound directory
  6742.                FILES Mail:Inbound
  6743.  
  6744.                ; This is the directory where ConfMail temporarily stores
  6745.                ; unpacked mail bundles
  6746.                PACKET t:
  6747.  
  6748.                ; Your command for arc'ing mail.  This example uses zoo,
  6749.                ; but archiving methods used vary.
  6750.                ARC Zoo a
  6751.  
  6752.                ; This is your unarc command.  Again, Zoo is used in this
  6753.                ; example, but it will vary.
  6754.                UNARC Zoo x
  6755.  
  6756.                ; These commands tell ConfMail what to do with your netmail
  6757.                ; directory
  6758.                NETMAIL Mail:Matrix
  6759.                DO_NETMAIL
  6760.  
  6761.  
  6762.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  6763.  
  6764.  
  6765.  
  6766.  
  6767.  
  6768.           TransAmiga BBS User Manual                                Page 108
  6769.  
  6770.  
  6771.                FWD_REPLIES
  6772.  
  6773.                ; Tell ConfMail to update TransAmiga's last read pointers on
  6774.                ; renumber
  6775.                TRANSAMIGA
  6776.  
  6777.  
  6778.  
  6779.  
  6780.  
  6781.  
  6782.  
  6783.  
  6784.  
  6785.  
  6786.  
  6787.  
  6788.  
  6789.  
  6790.  
  6791.  
  6792.  
  6793.  
  6794.  
  6795.  
  6796.  
  6797.  
  6798.  
  6799.  
  6800.  
  6801.  
  6802.  
  6803.  
  6804.  
  6805.  
  6806.  
  6807.  
  6808.  
  6809.  
  6810.  
  6811.  
  6812.  
  6813.  
  6814.  
  6815.  
  6816.  
  6817.  
  6818.  
  6819.  
  6820.  
  6821.  
  6822.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  6823.  
  6824.  
  6825.  
  6826.  
  6827.  
  6828.           TransAmiga BBS User Manual                                Page 109
  6829.  
  6830.  
  6831.                                      Appendix II
  6832.  
  6833.  
  6834.           BBS Tools Reference:
  6835.  
  6836.                This appendix  provides a  quick reference on the use of all
  6837.                of the included TransAmiga tools.  All these  programmes can
  6838.                be found in Bin directory.
  6839.  
  6840.  
  6841.           TransAmiga Access Lock:
  6842.  
  6843.                Usage: TrAL L|U
  6844.                Pronunciation: TRAWL
  6845.  
  6846.                Either locks  (L) or unlocks (U) TransAmiga's message areas.
  6847.                When the areas are  locked, all  message areas  become read-
  6848.                only, and users will not be allowed to save messages.
  6849.  
  6850.                Warning, this  only has any real effect while there is a BBS
  6851.                line    running     (or    anything     else    that    uses
  6852.                transamiga.library).    There  is little chance that locking
  6853.                will have any effect if TrAL  is used  before any  BBS lines
  6854.                are running,  and there  is an equally small chance that the
  6855.                lock will be retained after all lines have been exited.
  6856.  
  6857.  
  6858.           TransAmiga BBS:
  6859.  
  6860.                Usage: TransAmiga -c<config file> [-b<baud rate>] [-l<locked
  6861.                     baud rate] [-t<max time>] [-n<line>] [-x] [-r] [-s]
  6862.  
  6863.                Starts up the  BBS.    See  earlier  on  in  the  manual for
  6864.                complete details.
  6865.  
  6866.  
  6867.           TransAmiga BBS Line Activity Display:
  6868.  
  6869.                Usage: TrBLAD [<line>]
  6870.  
  6871.                Displays all current BBS activity in a similar manner to the
  6872.                "Who's Online" command from the main  menu.   If no specific
  6873.                <line> is specified, all lines will be listed.
  6874.  
  6875.  
  6876.           TransAmiga Broadcaster:
  6877.  
  6878.                Usage: TrBroad <message> -n<line>
  6879.  
  6880.  
  6881.  
  6882.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  6883.  
  6884.  
  6885.  
  6886.  
  6887.  
  6888.           TransAmiga BBS User Manual                                Page 110
  6889.  
  6890.  
  6891.                Sends an online message to the indicated line number.
  6892.  
  6893.  
  6894.           TransAmiga Configuration Tool:
  6895.  
  6896.                Usage: TransCfg -c<config file>
  6897.  
  6898.                Setup  up  and/or  edit TransAmiga's configuration.  <config
  6899.                file> is the name of TransAmiga's master configuration file.
  6900.  
  6901.  
  6902.           TransAmiga File Lister:
  6903.  
  6904.                Usage: TrFL -o<out file> -c<configs dir> [-t<title>]
  6905.                     [-a<access>] [-d<days>] [-s] [-n]
  6906.                Pronunciation: TRY-full
  6907.  
  6908.                Creates a readable text file listing files available  in the
  6909.                file section.   <out  file> is  the name of the text file to
  6910.                create.   <configs  dir>  is  the  name  of  your TransAmiga
  6911.                configurations directory.   <title> is an optional text file
  6912.                that will be inserted  at  the  top  of  the  generated file
  6913.                listing.  Specifying <access> allows you to limit what areas
  6914.                are included: only areas  with this  level or  lower will be
  6915.                listed  in  the  generated  file.   <days> defines what is a
  6916.                "new" file.  New files are  marked with  an asterisk  (*) in
  6917.                the output  file.   Specifying -n tells TrFL to include only
  6918.                files that are new.  Finally,  -s  tells  TrFL  to  sort the
  6919.                output  file.    TrFL  is  very intelligent about this, when
  6920.                sorting it will not  move around  comment lines  in the file
  6921.                listing (lines starting with a backslash), and will sort the
  6922.                files  inbetween  the  comment  lines,  and  not  move  them
  6923.                elsewhere.
  6924.  
  6925.  
  6926.           TransAmiga User Maintenance:
  6927.  
  6928.                Usage: TrMaint -c<config file> [-n<line number>]
  6929.  
  6930.                Starts  the  remote  SysOp  user maintenance module.  If you
  6931.                specify a line number, TrMaint assumes that it will be going
  6932.                through the  BBS as  a door.   Otherwise, it will simply run
  6933.                from the CLI.
  6934.  
  6935.  
  6936.           TransAmiga DOS Shell:
  6937.  
  6938.                Usage: TrShell -n<line number> -f<FIFO name>
  6939.  
  6940.  
  6941.  
  6942.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  6943.  
  6944.  
  6945.  
  6946.  
  6947.  
  6948.           TransAmiga BBS User Manual                                Page 111
  6949.  
  6950.  
  6951.                Starts up  TransAmiga remote  shell.   This can  only be run
  6952.                from within the BBS as a door.
  6953.  
  6954.                This is  a full interactive shell, supporting things such as
  6955.                simple command line editting, and "raw" mode.   It will also
  6956.                check for carrier loss and user idle timeout, in these cases
  6957.                it will send a CTRL-C break to the running programme.
  6958.  
  6959.                In order to run, TrShell requires  that the  FIFO: device be
  6960.                properly installed  on your  system.  This requires that you
  6961.                copy the fifo.library  file  to  your  Libs:  directory, the
  6962.                fifo-handler file  to your  L: directory, which also must be
  6963.                executed in your Startup-Sequence.
  6964.  
  6965.                For TrShell to work  properly, you  should first  start up a
  6966.                new  CLI  process,  with  all  it's  input  and output going
  6967.                through  FIFO:.    Note  how  a  unique  FIFO  name  must be
  6968.                generated for  each invocation, in the example below this is
  6969.                done with the ARexx  pragma("id") function.   An  example of
  6970.                starting TrShell from ARexx would be:
  6971.  
  6972.                  /* ARexx macro to start the remote shell */
  6973.  
  6974.                  options result
  6975.  
  6976.                  id=time("s")
  6977.                  SYSTEMINFO 8 ; bbsline=result
  6978.  
  6979.                  address command 'NewShell FIFO:trshell'id'/rwkecs'
  6980.                  address command 'TrShell -n'bbsline' -ftrshell'id
  6981.  
  6982.                  exit
  6983.  
  6984.                "trshell" is the unique filename that you must pass to FIFO:
  6985.                and also to TrShell (they must be identical!);  the BBS line
  6986.                number is  appended to  the end to avoid conflicts on multi-
  6987.                line systems.  The "/rwkecs"  are  the  parameters  that are
  6988.                required for FIFO: to work correctly with TrShell.
  6989.  
  6990.  
  6991.           Tell TransAmiga ARexx Commands:
  6992.  
  6993.                Usage: TrTell [-n<line number>] <command>
  6994.  
  6995.                Sends  a  TransAmiga  ARexx  command  to a currently running
  6996.                line.  Usually this is used  when you've  started TransAmiga
  6997.                with the  -r option  and it  is just  sitting waiting for an
  6998.                ARexx messages.  The  same result  can be  achieved by using
  6999.                the RX command, this way just takes a little less typing.
  7000.  
  7001.  
  7002.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  7003.  
  7004.  
  7005.  
  7006.  
  7007.  
  7008.           TransAmiga BBS User Manual                                Page 112
  7009.  
  7010.  
  7011.  
  7012.                If your  command is  more than  one word, you should enclose
  7013.                the command in quotes, eg:
  7014.  
  7015.                  TrTell -n0 "baudrate 2400"
  7016.                  TrTell -n0 logon
  7017.  
  7018.                (the commands are case-insensitive).
  7019.  
  7020.                Sending ARexx messages while a user  is online  is generally
  7021.                not a good idea, and can lead to unpredictable results.  You
  7022.                should only use  this  command  in  the  situation described
  7023.                above.
  7024.  
  7025.  
  7026.           TransAmiga Update File Areas:
  7027.  
  7028.                Usage: TrUFL <file dir>
  7029.                Pronuncation: TRUH-full
  7030.  
  7031.                This searches through the specified file directory for files
  7032.                not listed in TransAmiga's  Files.BBS,  and  prompts  you to
  7033.                enter a  description so  that it  will be  added to the file
  7034.                listing.  If you do not wish to add it,  simply press RETURN
  7035.                at the  prompt.   No long description will be given, and the
  7036.                uploader's name will be set as "SysOp".  This can  easily be
  7037.                edited simply  by loading up the appropriate .Desc file in a
  7038.                text editor.
  7039.  
  7040.                TrUFL also searches for  files that  are listed  in the file
  7041.                listing  but  not  actually  present  in the file directory.
  7042.                This is handy if you've moved or deleted  the file  from the
  7043.                Shell or  Workbench, and  have forgotten  to update the file
  7044.                listing.
  7045.  
  7046.  
  7047.           TransAmiga Update Message Pointers:
  7048.  
  7049.                Usage: TrUMP <msg dir> [<msg dir>...]
  7050.  
  7051.                This searches for the high and  low message  pointers in the
  7052.                specified  netmail  or  echomail  message directories.  This
  7053.                must be run when any programme other than  TransAmiga adds a
  7054.                message to an area, otherwise TransAmiga will have incorrect
  7055.                values for the message pointers.
  7056.  
  7057.                Due to slight differences in the way TransAmiga treats local
  7058.                and  privileged-only  areas,  you  must  never  use TrUMP on
  7059.                directories of these types.
  7060.  
  7061.  
  7062.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  7063.  
  7064.  
  7065.  
  7066.  
  7067.  
  7068.           TransAmiga BBS User Manual                                Page 113
  7069.  
  7070.  
  7071.                                     Appendix III
  7072.  
  7073.  
  7074.           Amiga ANSI Codes:
  7075.  
  7076.                This is a complete references  section  for  the  ANSI codes
  7077.                that  TransAmiga)  understands.    For maximum compatibility
  7078.                with  various  terminal  types,   TransAmiga  understands  a
  7079.                combination of both IBM ANSI codes, and Amiga console.device
  7080.                ANSI codes.
  7081.  
  7082.  
  7083.           Colour Change Codes:
  7084.  
  7085.                ESC [30m       - black foreground
  7086.                ESC [31m       - red foreground
  7087.                ESC [32m       - green foreground
  7088.                ESC [33m       - yellow foreground
  7089.                ESC [34m       - blue foreground
  7090.                ESC [35m       - purple foreground
  7091.                ESC [36m       - cyan foreground
  7092.                ESC [37m       - white foreground
  7093.  
  7094.                ESC [40m       - black background
  7095.                ESC [41m       - red background
  7096.                ESC [42m       - green background
  7097.                ESC [43m       - yellow background
  7098.                ESC [44m       - blue background
  7099.                ESC [45m       - purple background
  7100.                ESC [46m       - cyan background
  7101.                ESC [47m       - white background
  7102.  
  7103.  
  7104.           Style Controls:
  7105.  
  7106.                ESC [0m        - reset ANSI codes
  7107.                ESC [1m        - boldface on (*)
  7108.                ESC [3m        - italics on
  7109.                ESC [4m        - underline on
  7110.                ESC [7m        - inverse on
  7111.  
  7112.                (*)  In 16 colour  ANSI,  boldface  text  is  rendered  as a
  7113.                     slightly brighter colour, thus giving you access to the
  7114.                     8 additional colours in the palette.
  7115.  
  7116.  
  7117.           Cursor Controls:
  7118.  
  7119.                ESC [A         - cursor up
  7120.  
  7121.  
  7122.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  7123.  
  7124.  
  7125.  
  7126.  
  7127.  
  7128.           TransAmiga BBS User Manual                                Page 114
  7129.  
  7130.  
  7131.                ESC [B         - cursor down
  7132.                ESC [C         - cursor right
  7133.                ESC [D         - cursor left
  7134.  
  7135.                ESC [#A        - cursor up # lines
  7136.                ESC [#B        - cursor down # lines
  7137.                ESC [#C        - cursor right # spaces
  7138.                ESC [#D        - cursor left # spaces
  7139.  
  7140.                ESC [H         - cursor home
  7141.                ESC [#H        - cursor to line #
  7142.                ESC [#;#H      - cursor to a specific row and column
  7143.  
  7144.                ESC [s         - save the current cursor position
  7145.                ESC [u         - restore cursor to the last saved position
  7146.  
  7147.  
  7148.           Miscellaneous Commands:
  7149.  
  7150.                ESC [@         - insert a space
  7151.                ESC [#@        - insert # spaces
  7152.  
  7153.                ESC [L         - insert line
  7154.                ESC [#L        - insert # lines
  7155.  
  7156.                ESC [M         - delete line
  7157.                ESC [#M        - delete # lines
  7158.  
  7159.                ESC [P         - delete character
  7160.                ESC [#P        - Delete # characters
  7161.  
  7162.                ESC [K         - delete to end of line
  7163.                ESC [1K        - delete to start of line
  7164.                ESC [2K        - delete entire line
  7165.  
  7166.                ESC [J         - clear to end of screen
  7167.                ESC [1J        - clear to top of screen
  7168.                ESC [2J        - clear entire screen
  7169.  
  7170.                NOTE: some ANSI commands can be stacked using the semi-colon
  7171.                (;), eg:
  7172.  
  7173.                  ESC [1;43;34m     - blue bold text on yellow background
  7174.  
  7175.  
  7176.  
  7177.  
  7178.  
  7179.  
  7180.  
  7181.  
  7182.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  7183.  
  7184.  
  7185.  
  7186.  
  7187.  
  7188.           TransAmiga BBS User Manual                                Page 115
  7189.  
  7190.  
  7191.  
  7192.  
  7193.  
  7194.                                    G L O S S A R Y
  7195.                                    ---------------
  7196.  
  7197.  
  7198.  
  7199.  
  7200.           Access Levels:
  7201.  
  7202.                A means of restricting users from using certain parts of the
  7203.                BBS.  When an  access level  is specified  for a  command or
  7204.                area in TransAmiga, that function becomes invisible to users
  7205.                who have an access level  lower  than  that  number.   Valid
  7206.                access levels range from 1 to 255.
  7207.  
  7208.  
  7209.           ANSI Graphics:
  7210.  
  7211.                A format  for sending  simple graphics  information.  It has
  7212.                codes for changing colours,  moving the  cursor, etc.   Most
  7213.                terminal programmes and BBS's support this protocol.
  7214.  
  7215.  
  7216.           Archive:
  7217.  
  7218.                A single file that contains several other files encoded into
  7219.                it.  Usually some  kind  of  compression  is  done  on these
  7220.                files.   Special tools  are needed  to add and extract files
  7221.                from archives.  There  exist various  archiving methods such
  7222.                as: LHarc  and Zoo,  which are characterized by the suffixes
  7223.                .Lzh and .Zoo on the filenames of their respective archives.
  7224.  
  7225.  
  7226.           ARexx:
  7227.  
  7228.                A high level scripting language for the Amiga that is unique
  7229.                in   that   it   defines   a   protocol   for  inter-process
  7230.                communication,  allowing  non-programmers  to  create macros
  7231.                that control other software.
  7232.  
  7233.  
  7234.           Batch Transfer:
  7235.  
  7236.                A transfer in which several files will be sent automatically
  7237.                one after  another where  no extra  work is  required by the
  7238.                users between each transfer.  Only certain protocols such as
  7239.                Zmodem are capable of batch transfers.
  7240.  
  7241.  
  7242.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  7243.  
  7244.  
  7245.  
  7246.  
  7247.  
  7248.           TransAmiga BBS User Manual                                Page 116
  7249.  
  7250.  
  7251.  
  7252.  
  7253.           BBS:
  7254.  
  7255.                Bulletin Board System.   A piece  of computer  software that
  7256.                will automatically  receive calls  over the  modem and allow
  7257.                callers to perform various  functions  such  as  posting and
  7258.                reading messages, sending and receiving file, etc.
  7259.  
  7260.  
  7261.           Door:
  7262.  
  7263.                A programme that is executed by the BBS to perform some sort
  7264.                of outside function.  Now  an  obsolete  term,  as  most BBS
  7265.                packages work  interactively with  external programmes these
  7266.                days.
  7267.  
  7268.  
  7269.           Download:
  7270.  
  7271.                To receive a file over the modem.
  7272.  
  7273.  
  7274.           Echo:
  7275.  
  7276.                A FidoNet message area, where all  messages posted  are sent
  7277.                through FidoNet  to all  other systems  that wish to receive
  7278.                that echo.  In essence, a public message conference.
  7279.  
  7280.  
  7281.           FidoNet:
  7282.  
  7283.                A  non-profit  publicly   accessible   network   of  several
  7284.                thousand   computer   users   all   around  the  world  (but
  7285.                predominantly in North America,  Europe and  Australia) that
  7286.                allows for the transferring of messages and files.
  7287.  
  7288.  
  7289.           Freeware:
  7290.  
  7291.                A concept  of software  distribution in  which the author(s)
  7292.                retain a copyright over the programme, but require no fee to
  7293.                use it.
  7294.  
  7295.  
  7296.           FTS-0001:
  7297.  
  7298.                The  basic  FidoNet  technical  document  that describes the
  7299.                message format, packet format, and mailer protocol.
  7300.  
  7301.  
  7302.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  7303.  
  7304.  
  7305.  
  7306.  
  7307.  
  7308.           TransAmiga BBS User Manual                                Page 117
  7309.  
  7310.  
  7311.  
  7312.  
  7313.           Intuition:
  7314.  
  7315.                The Amiga's graphical user  interface.    Intuition provides
  7316.                such aspects  of the  Amiga's operating system and pull-down
  7317.                menus, windows,  gadgets,  etc.    Intuition  is  held  in a
  7318.                shared-library in ROM.
  7319.  
  7320.  
  7321.           Kludge Lines:
  7322.  
  7323.                Special  lines  that  appear  in  FidoNet  messages that are
  7324.                intended to give more  information to  programmes processing
  7325.                FidoNet messages.   A CTRL a (ASCII code 1) precedes them to
  7326.                identify them as kludges.  TransAmiga displays these in bold
  7327.                text and can only be viewed by those with privileged access.
  7328.  
  7329.  
  7330.           Mailer:
  7331.  
  7332.                A programme that makes and receives calls for the delivering
  7333.                and picking up of mail bundles and other files.  Used within
  7334.                FidoNet.    Usually  this  will  also act as a frontend to a
  7335.                FidoNet BBS, answering incoming  calls and  spawning the BBS
  7336.                when necessary.  Eg. TrapDoor, Welmat.
  7337.  
  7338.  
  7339.           Mail Processor:
  7340.  
  7341.                A programme  used to  unpack incoming  mail bundles and toss
  7342.                them into the correct  areas, and  to pack  up outgoing mail
  7343.                into bundles  ready for  sending.   Eg. ConfMail, FastPoint,
  7344.                GCCHost, Foozle.
  7345.  
  7346.  
  7347.           Matrix Mail:
  7348.  
  7349.                See Netmail.
  7350.  
  7351.  
  7352.           Message Header:
  7353.  
  7354.                The part of the  message that  contains such  information as
  7355.                who sent it, who it was sent to, date it was sent, etc.
  7356.  
  7357.  
  7358.           Multi-Line:
  7359.  
  7360.  
  7361.  
  7362.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  7363.  
  7364.  
  7365.  
  7366.  
  7367.  
  7368.           TransAmiga BBS User Manual                                Page 118
  7369.  
  7370.  
  7371.                The ability  for a BBS to somehow handle multiple callers on
  7372.                multiple phone lines at the same time.
  7373.  
  7374.  
  7375.           Netmail:
  7376.  
  7377.                Messages sent through FidoNet  to  a  specific  person  at a
  7378.                specific FidoNet address.  Usually used to send mail that is
  7379.                intended to be relatively  private.    Also  referred  to as
  7380.                Matrix Mail.
  7381.  
  7382.  
  7383.           Path Name:
  7384.  
  7385.                Refers to  the full  AmigaDOS reference to the location of a
  7386.                file.  This includes the device or volume  name which should
  7387.                be followed by a colon (:); followed by any directories that
  7388.                the file may be in, followed by a slash (/); followed by the
  7389.                file name itself.  Example: Sys:Utilities/Calculator
  7390.  
  7391.  
  7392.           Public Domain:
  7393.  
  7394.                When  referring  to  software,  it  means that the author(s)
  7395.                gives up all rights over the software, allowing anyone to do
  7396.                whatever they like to it.
  7397.  
  7398.  
  7399.           Protocol:
  7400.  
  7401.                A  special  means  to  transfer  files  over  the modem that
  7402.                insures that the file  arrives  error  free.    Examples are
  7403.                Xmodem, Zmodem, Xmodem-1k, etc.
  7404.  
  7405.  
  7406.           Release 2:
  7407.  
  7408.                Refers  to  the  second  generation of the Amiga's operating
  7409.                system.  Often referred to as Workbench 2.0 or just 2.0.
  7410.  
  7411.  
  7412.           Return Code:
  7413.  
  7414.                A code sent  to  AmigaDOS  by  a  programme  when  it exits.
  7415.                Usually to provide information about what that programme has
  7416.                done so certain actions can be handled by a script file.
  7417.  
  7418.  
  7419.           Session Handler:
  7420.  
  7421.  
  7422.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  7423.  
  7424.  
  7425.  
  7426.  
  7427.  
  7428.           TransAmiga BBS User Manual                                Page 119
  7429.  
  7430.  
  7431.  
  7432.                See Mailer.
  7433.  
  7434.  
  7435.           Shared Library:
  7436.  
  7437.                A collection of predefined  functions  that  programmers can
  7438.                use in  their programmers.   They  can either  reside in the
  7439.                Amiga's ROM (such as  the intuition.library)  or on  disk in
  7440.                the Libs: directory (such as the diskfont.library).
  7441.  
  7442.  
  7443.           Shareware:
  7444.  
  7445.                A concept  of software  distribution where  some form of the
  7446.                software  is  provided  free,  and  users  are  required  to
  7447.                "register"  after  a  certain  period  of time.  Registering
  7448.                normally includes a fee.
  7449.  
  7450.  
  7451.           Upload:
  7452.  
  7453.                To send a file to another system over the modem.
  7454.  
  7455.  
  7456.           Upload:Download Ratio:
  7457.  
  7458.                A means of restricting people from downloading too much, and
  7459.                forcing them to upload.  For every specified amount of files
  7460.                they download, they must  upload  one.    If  the  reach the
  7461.                download limit without a corresponding upload, they will not
  7462.                be allowed to download anymore  until  a  file  is uploaded.
  7463.                Ideally, a  circle is created: the more people download, the
  7464.                more they must upload, and  the  more  files  there  are for
  7465.                downloading, the more people will download.
  7466.  
  7467.  
  7468.           XPR Protocols:
  7469.  
  7470.                A method  of implementing file transfer protocols externally
  7471.                on the  Amiga.    Each  protocol  lives  in  its  own shared
  7472.                library,  which  contains  a  standard  set of functions for
  7473.                transferring files.   An  XPR supporting  application can be
  7474.                made  to  work  with  any  number  of  protocols  simply  by
  7475.                installing new libraries.
  7476.  
  7477.  
  7478.  
  7479.  
  7480.  
  7481.  
  7482.           TransAmiga BBS v1.1               Copyright 1991 by Timothy Aston
  7483. c